Compare commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
60a75f8159 | ||
|
|
b41cb8d3af | ||
|
|
d676635325 | ||
|
|
f02f9424a5 | ||
|
|
2302fbc843 | ||
|
|
c1c80f3cc8 | ||
|
|
1c420ad2f3 | ||
|
|
e27180633f | ||
|
|
4949910587 | ||
|
|
706bd2795c | ||
|
|
e733c6b40b | ||
|
|
d9e1480c74 | ||
|
|
f3da910b4f |
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "ponytail",
|
||||
"version": "4.3.0",
|
||||
"version": "4.5.0",
|
||||
"description": "Lazy senior dev mode. Forces the simplest, shortest solution that actually works: YAGNI, stdlib first, no unrequested abstractions.",
|
||||
"author": {
|
||||
"name": "Dietrich Gebert",
|
||||
|
||||
@@ -21,4 +21,4 @@ Rules:
|
||||
- Pick the edge-case-correct option when two stdlib approaches are the same size, lazy means less code, not the flimsier algorithm.
|
||||
- Mark intentional simplifications with a `ponytail:` comment. If the shortcut has a known ceiling (global lock, O(n²) scan, naive heuristic), the comment names the ceiling and the upgrade path.
|
||||
|
||||
Not lazy about: input validation at trust boundaries, error handling that prevents data loss, security, accessibility, anything explicitly requested. Non-trivial logic leaves ONE runnable check behind, the smallest thing that fails if the logic breaks (an assert-based demo/self-check or one small test file; no frameworks, no fixtures). Trivial one-liners need no test.
|
||||
Not lazy about: input validation at trust boundaries, error handling that prevents data loss, security, accessibility, the calibration real hardware needs (the platform is never the spec ideal, a clock drifts, a sensor reads off), anything explicitly requested. Lazy code without its check is unfinished: non-trivial logic leaves ONE runnable check behind, the smallest thing that fails if the logic breaks (an assert-based demo/self-check or one small test file; no frameworks, no fixtures). Trivial one-liners need no test.
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "ponytail",
|
||||
"version": "4.3.0",
|
||||
"version": "4.5.0",
|
||||
"description": "Lazy senior dev mode. Forces the simplest, shortest solution that actually works: YAGNI, stdlib first, no unrequested abstractions.",
|
||||
"author": {
|
||||
"name": "Dietrich Gebert",
|
||||
|
||||
@@ -27,4 +27,4 @@ Rules:
|
||||
- Pick the edge-case-correct option when two stdlib approaches are the same size, lazy means less code, not the flimsier algorithm.
|
||||
- Mark intentional simplifications with a `ponytail:` comment. If the shortcut has a known ceiling (global lock, O(n²) scan, naive heuristic), the comment names the ceiling and the upgrade path.
|
||||
|
||||
Not lazy about: input validation at trust boundaries, error handling that prevents data loss, security, accessibility, anything explicitly requested. Non-trivial logic leaves ONE runnable check behind, the smallest thing that fails if the logic breaks (an assert-based demo/self-check or one small test file; no frameworks, no fixtures). Trivial one-liners need no test.
|
||||
Not lazy about: input validation at trust boundaries, error handling that prevents data loss, security, accessibility, the calibration real hardware needs (the platform is never the spec ideal, a clock drifts, a sensor reads off), anything explicitly requested. Lazy code without its check is unfinished: non-trivial logic leaves ONE runnable check behind, the smallest thing that fails if the logic breaks (an assert-based demo/self-check or one small test file; no frameworks, no fixtures). Trivial one-liners need no test.
|
||||
|
||||
@@ -21,4 +21,4 @@ Rules:
|
||||
- Pick the edge-case-correct option when two stdlib approaches are the same size, lazy means less code, not the flimsier algorithm.
|
||||
- Mark intentional simplifications with a `ponytail:` comment. If the shortcut has a known ceiling (global lock, O(n²) scan, naive heuristic), the comment names the ceiling and the upgrade path.
|
||||
|
||||
Not lazy about: input validation at trust boundaries, error handling that prevents data loss, security, accessibility, anything explicitly requested. Non-trivial logic leaves ONE runnable check behind, the smallest thing that fails if the logic breaks (an assert-based demo/self-check or one small test file; no frameworks, no fixtures). Trivial one-liners need no test.
|
||||
Not lazy about: input validation at trust boundaries, error handling that prevents data loss, security, accessibility, the calibration real hardware needs (the platform is never the spec ideal, a clock drifts, a sensor reads off), anything explicitly requested. Lazy code without its check is unfinished: non-trivial logic leaves ONE runnable check behind, the smallest thing that fails if the logic breaks (an assert-based demo/self-check or one small test file; no frameworks, no fixtures). Trivial one-liners need no test.
|
||||
|
||||
@@ -0,0 +1,20 @@
|
||||
{
|
||||
"name": "ponytail",
|
||||
"description": "Lazy senior dev mode for AI agents. The best code is the code you never wrote.",
|
||||
"owner": {
|
||||
"name": "Dietrich Gebert",
|
||||
"url": "https://github.com/DietrichGebert"
|
||||
},
|
||||
"plugins": [
|
||||
{
|
||||
"name": "ponytail",
|
||||
"description": "Forces the laziest solution that works. YAGNI, stdlib first, one line over fifty.",
|
||||
"source": "./",
|
||||
"category": "productivity",
|
||||
"tags": ["yagni", "minimalism", "code-review", "productivity"],
|
||||
"commands": "commands/",
|
||||
"skills": "skills/",
|
||||
"hooks": "hooks/copilot-hooks.json"
|
||||
}
|
||||
]
|
||||
}
|
||||
@@ -0,0 +1,16 @@
|
||||
{
|
||||
"name": "ponytail",
|
||||
"description": "Lazy senior dev mode. Forces the simplest, shortest solution that actually works: YAGNI, stdlib first, no unrequested abstractions.",
|
||||
"version": "4.5.0",
|
||||
"author": {
|
||||
"name": "Dietrich Gebert",
|
||||
"url": "https://github.com/DietrichGebert"
|
||||
},
|
||||
"homepage": "https://github.com/DietrichGebert/ponytail",
|
||||
"repository": "https://github.com/DietrichGebert/ponytail",
|
||||
"license": "MIT",
|
||||
"keywords": ["yagni", "minimalism", "code-review", "productivity"],
|
||||
"commands": "commands/",
|
||||
"skills": "skills/",
|
||||
"hooks": "hooks/copilot-hooks.json"
|
||||
}
|
||||
@@ -0,0 +1,29 @@
|
||||
name: test
|
||||
|
||||
on:
|
||||
push:
|
||||
branches: [main]
|
||||
pull_request:
|
||||
|
||||
jobs:
|
||||
test:
|
||||
runs-on: ubuntu-latest
|
||||
steps:
|
||||
- uses: actions/checkout@v4
|
||||
|
||||
- uses: actions/setup-node@v4
|
||||
with:
|
||||
node-version: '22'
|
||||
|
||||
- uses: actions/setup-python@v5
|
||||
with:
|
||||
python-version: '3.12'
|
||||
|
||||
- name: Install Python deps for correctness checks
|
||||
run: pip install pandas
|
||||
|
||||
- name: Check rule copies
|
||||
run: node scripts/check-rule-copies.js
|
||||
|
||||
- name: Run tests
|
||||
run: npm test
|
||||
@@ -9,3 +9,8 @@ node_modules/
|
||||
# promptfoo eval artifacts
|
||||
.promptfoo/
|
||||
benchmarks/output*
|
||||
|
||||
# one-off social/announcement art, not repo content
|
||||
announce-*.png
|
||||
changelog-*.png
|
||||
ponytail-*.gif
|
||||
|
||||
@@ -26,4 +26,4 @@ Rules:
|
||||
- Pick the edge-case-correct option when two stdlib approaches are the same size, lazy means less code, not the flimsier algorithm.
|
||||
- Mark intentional simplifications with a `ponytail:` comment. If the shortcut has a known ceiling (global lock, O(n²) scan, naive heuristic), the comment names the ceiling and the upgrade path.
|
||||
|
||||
Not lazy about: input validation at trust boundaries, error handling that prevents data loss, security, accessibility, anything explicitly requested. Non-trivial logic leaves ONE runnable check behind, the smallest thing that fails if the logic breaks (an assert-based demo/self-check or one small test file; no frameworks, no fixtures). Trivial one-liners need no test.
|
||||
Not lazy about: input validation at trust boundaries, error handling that prevents data loss, security, accessibility, the calibration real hardware needs (the platform is never the spec ideal, a clock drifts, a sensor reads off), anything explicitly requested. Lazy code without its check is unfinished: non-trivial logic leaves ONE runnable check behind, the smallest thing that fails if the logic breaks (an assert-based demo/self-check or one small test file; no frameworks, no fixtures). Trivial one-liners need no test.
|
||||
|
||||
@@ -0,0 +1,5 @@
|
||||
---
|
||||
description: Harvest ponytail: comments into a tracked debt ledger
|
||||
---
|
||||
|
||||
Harvest every `ponytail:` comment in this repository into a debt ledger so deferrals do not rot into 'later means never'. Grep the whole tree for comment markers (grep -rnE '(#|//) ?ponytail:' ., skipping node_modules/.git/build output). One row per marker, grouped by file: <file>:<line> — <what was simplified>. ceiling: <the limit named in the comment>. upgrade: <the trigger to revisit>. Tag any marker that names no upgrade path or trigger as no-trigger, those rot silently. End with the count of markers and how many lack a trigger. If none: 'No ponytail: debt. Clean ledger.' Report only, change nothing.
|
||||
@@ -21,4 +21,4 @@ Rules:
|
||||
- Pick the edge-case-correct option when two stdlib approaches are the same size, lazy means less code, not the flimsier algorithm.
|
||||
- Mark intentional simplifications with a `ponytail:` comment. If the shortcut has a known ceiling (global lock, O(n²) scan, naive heuristic), the comment names the ceiling and the upgrade path.
|
||||
|
||||
Not lazy about: input validation at trust boundaries, error handling that prevents data loss, security, accessibility, anything explicitly requested. Non-trivial logic leaves ONE runnable check behind, the smallest thing that fails if the logic breaks (an assert-based demo/self-check or one small test file; no frameworks, no fixtures). Trivial one-liners need no test.
|
||||
Not lazy about: input validation at trust boundaries, error handling that prevents data loss, security, accessibility, the calibration real hardware needs (the platform is never the spec ideal, a clock drifts, a sensor reads off), anything explicitly requested. Lazy code without its check is unfinished: non-trivial logic leaves ONE runnable check behind, the smallest thing that fails if the logic breaks (an assert-based demo/self-check or one small test file; no frameworks, no fixtures). Trivial one-liners need no test.
|
||||
|
||||
@@ -21,6 +21,6 @@ Rules:
|
||||
- Pick the edge-case-correct option when two stdlib approaches are the same size, lazy means less code, not the flimsier algorithm.
|
||||
- Mark intentional simplifications with a `ponytail:` comment. If the shortcut has a known ceiling (global lock, O(n²) scan, naive heuristic), the comment names the ceiling and the upgrade path.
|
||||
|
||||
Not lazy about: input validation at trust boundaries, error handling that prevents data loss, security, accessibility, anything explicitly requested. Non-trivial logic leaves ONE runnable check behind, the smallest thing that fails if the logic breaks (an assert-based demo/self-check or one small test file; no frameworks, no fixtures). Trivial one-liners need no test.
|
||||
Not lazy about: input validation at trust boundaries, error handling that prevents data loss, security, accessibility, the calibration real hardware needs (the platform is never the spec ideal, a clock drifts, a sensor reads off), anything explicitly requested. Lazy code without its check is unfinished: non-trivial logic leaves ONE runnable check behind, the smallest thing that fails if the logic breaks (an assert-based demo/self-check or one small test file; no frameworks, no fixtures). Trivial one-liners need no test.
|
||||
|
||||
(Yes, this file also applies to agents working on the ponytail repo itself. Especially to them.)
|
||||
|
||||
@@ -1,5 +1,8 @@
|
||||
<p align="center">
|
||||
<img src="assets/logo.png" width="220" alt="Ponytail, the lazy senior dev">
|
||||
<picture>
|
||||
<source media="(prefers-color-scheme: dark)" srcset="assets/logo-dark.png">
|
||||
<img src="assets/logo.png" width="220" alt="Ponytail, the lazy senior dev">
|
||||
</picture>
|
||||
</p>
|
||||
|
||||
<h1 align="center">Ponytail</h1>
|
||||
@@ -11,7 +14,7 @@
|
||||
<p align="center">
|
||||
<img src="https://img.shields.io/github/stars/DietrichGebert/ponytail?style=flat-square&color=111111&label=stars" alt="Stars">
|
||||
<img src="https://img.shields.io/github/v/release/DietrichGebert/ponytail?style=flat-square&color=111111&label=release" alt="Release">
|
||||
<img src="https://img.shields.io/badge/works%20with-11%20agents-111111?style=flat-square" alt="Works with 11 agents">
|
||||
<img src="https://img.shields.io/badge/works%20with-13%20agents-111111?style=flat-square" alt="Works with 13 agents">
|
||||
<img src="https://img.shields.io/badge/license-MIT-111111?style=flat-square" alt="MIT license">
|
||||
</p>
|
||||
|
||||
@@ -68,6 +71,8 @@ Lazy, not negligent: trust-boundary validation, data-loss handling, security, an
|
||||
|
||||
The most effort ponytail will ever ask of you:
|
||||
|
||||
The Claude Code and Codex plugins run two tiny Node.js lifecycle hooks, so `node` needs to be on your PATH (note for Nix/nvm users: it must be on the non-interactive shell's PATH). If it isn't, the skills still work, the always-on activation just stays quiet instead of erroring on every prompt.
|
||||
|
||||
### Claude Code
|
||||
|
||||
```
|
||||
@@ -85,6 +90,29 @@ codex
|
||||
Open `/plugins`, select the Ponytail marketplace, and install Ponytail. Then
|
||||
open `/hooks`, review and trust its two lifecycle hooks, and start a new thread.
|
||||
|
||||
This same install also covers the Codex desktop app: restart the app after installing and it picks up the plugin.
|
||||
|
||||
### GitHub Copilot CLI
|
||||
|
||||
```bash
|
||||
copilot plugin marketplace add DietrichGebert/ponytail
|
||||
copilot plugin install ponytail@ponytail
|
||||
```
|
||||
|
||||
In an interactive Copilot CLI session, use the slash equivalents:
|
||||
|
||||
```
|
||||
/plugin marketplace add DietrichGebert/ponytail
|
||||
/plugin install ponytail@ponytail
|
||||
```
|
||||
|
||||
Copilot CLI namespaces plugin commands by plugin name. For example:
|
||||
|
||||
```text
|
||||
/ponytail:ponytail ultra
|
||||
/ponytail:ponytail-review
|
||||
```
|
||||
|
||||
### Pi agent harness
|
||||
|
||||
```
|
||||
@@ -99,7 +127,7 @@ Run OpenCode from a checkout of this repo (the plugin reuses its `hooks/` and `s
|
||||
{ "plugin": ["./.opencode/plugins/ponytail.mjs"] }
|
||||
```
|
||||
|
||||
Injects the ruleset every turn at the active level; adds `/ponytail`, `/ponytail-review`, and `/ponytail-audit`. OpenCode also auto-loads this repo's `AGENTS.md`, so the rules hold even without the plugin. The plugin adds the `lite/full/ultra/off` levels.
|
||||
Injects the ruleset every turn at the active level; adds the `/ponytail` commands (see [Commands](#commands)). OpenCode also auto-loads this repo's `AGENTS.md`, so the rules hold even without the plugin. The plugin adds the `lite/full/ultra/off` levels.
|
||||
|
||||
### Gemini CLI
|
||||
|
||||
@@ -107,34 +135,45 @@ Injects the ruleset every turn at the active level; adds `/ponytail`, `/ponytail
|
||||
gemini extensions install https://github.com/DietrichGebert/ponytail
|
||||
```
|
||||
|
||||
Loads the ruleset as always-on context every session and registers `/ponytail` and `/ponytail-review`; the `skills/` ship too, activated when a task needs them.
|
||||
Loads the ruleset as always-on context every session and registers the `/ponytail` commands; the `skills/` ship too, activated when a task needs them.
|
||||
|
||||
That was it. He'd be proud. He won't say it.
|
||||
|
||||
Active every session. `/ponytail-review` finds what to delete in your diff, `/ponytail-audit` does the same for the whole repo. `/ponytail ultra` exists for when the codebase has wronged you personally. `/ponytail-help` explains the rest.
|
||||
Active every session, with a handful of commands (see [Commands](#commands)). `/ponytail ultra` exists for when the codebase has wronged you personally. Startup and mode-change text shows the current mode.
|
||||
|
||||
In Codex, invoke the skills as `@ponytail`, `@ponytail-review`,
|
||||
`@ponytail-audit`, and `@ponytail-help`. Startup and mode-change text shows the
|
||||
current mode.
|
||||
|
||||
Cursor, Windsurf, Cline, Copilot, Aider, Kiro: copy the matching rules file from this repo ([`.cursor/rules/`](.cursor/rules/), [`.windsurf/rules/`](.windsurf/rules/), [`.clinerules/`](.clinerules/), [`.github/copilot-instructions.md`](.github/copilot-instructions.md), [`AGENTS.md`](AGENTS.md), [`.kiro/steering/`](.kiro/steering/)).
|
||||
Cursor, Windsurf, Cline, GitHub Copilot (editor), Aider, Kiro: copy the matching rules file from this repo ([`.cursor/rules/`](.cursor/rules/), [`.windsurf/rules/`](.windsurf/rules/), [`.clinerules/`](.clinerules/), [`.github/copilot-instructions.md`](.github/copilot-instructions.md), [`AGENTS.md`](AGENTS.md), [`.kiro/steering/`](.kiro/steering/)).
|
||||
|
||||
Kiro: copy `.kiro/steering/ponytail.md` to `~/.kiro/steering/` (global) or `.kiro/steering/` in your project.
|
||||
|
||||
GitHub Copilot CLI: it already reads `AGENTS.md` and `.github/copilot-instructions.md` in a project, or copy the rules into `~/.copilot/copilot-instructions.md` to run ponytail in every project.
|
||||
GitHub Copilot CLI fallback (instruction-only mode): it reads `AGENTS.md` and `.github/copilot-instructions.md` in a project, or copy the rules into `~/.copilot/copilot-instructions.md` to run ponytail in every project. This path keeps always-on guidance, but does not add plugin mode switches or hooks.
|
||||
|
||||
Antigravity and VS Code with the Codex extension: both read `AGENTS.md`, which this repo ships, so it works from the repo root with no setup (`~/.codex/AGENTS.md` makes Codex global, `.agents/rules/` makes it an always-on rule in Antigravity).
|
||||
|
||||
Which files map to which agent: [Agent portability](docs/agent-portability.md).
|
||||
|
||||
## Commands
|
||||
|
||||
| Command | What it does |
|
||||
|---------|--------------|
|
||||
| `/ponytail [lite \| full \| ultra \| off]` | Set the intensity, or turn it off. No argument reports the current level. |
|
||||
| `/ponytail-review` | Review the current diff for over-engineering, hands back a delete-list. |
|
||||
| `/ponytail-audit` | Audit the whole repo for over-engineering, not just the diff. |
|
||||
| `/ponytail-debt` | Harvest the `ponytail:` shortcuts you've deferred into a ledger, so "later" doesn't become "never". |
|
||||
| `/ponytail-help` | Quick reference for the commands above. |
|
||||
|
||||
Commands need a skill-capable host (Claude Code, Codex, OpenCode, Gemini, pi). In Codex they're skills, invoke with `@` (`@ponytail-review`). The instruction-only adapters (Cursor, Windsurf, Cline, Copilot, Kiro, Antigravity) load the always-on ruleset without the commands.
|
||||
|
||||
## Development
|
||||
|
||||
When changing the compact rule text, keep the agent copies aligned:
|
||||
|
||||
```bash
|
||||
node scripts/check-rule-copies.js
|
||||
npm test
|
||||
```
|
||||
|
||||
The correctness benchmark spawns Python for email and CSV checks; `python3` is tried before `python`. CSV checks need `pandas` installed locally.
|
||||
|
||||
## FAQ
|
||||
|
||||
**Does it need a config file?**
|
||||
|
||||
Binary file not shown.
|
After Width: | Height: | Size: 129 KiB |
File diff suppressed because one or more lines are too long
|
After Width: | Height: | Size: 84 KiB |
@@ -0,0 +1,58 @@
|
||||
// Behavior gate: does the ponytail ruleset actually PRODUCE its refined
|
||||
// behaviors, not just carry the text? One check per probe (vars.probe), each
|
||||
// targeting a rule that a field review (rcstack, phases 0-8) showed mattered:
|
||||
// hardware - "hardware is never the spec ideal, leave the calibration knob"
|
||||
// explanation - "explanation the user explicitly asked for is not debt"
|
||||
// onecheck - "lazy code without its check is unfinished"
|
||||
//
|
||||
// Heuristic graders, same spirit as loc.js / correctness.js. The graders
|
||||
// themselves are proven by tests/behavior.test.js (RED/GREEN, no API key).
|
||||
//
|
||||
// Metric: `behavior` (1 = behavior present, 0 = absent).
|
||||
|
||||
function codeOf(text) {
|
||||
return [...String(text || '').matchAll(/```[\w-]*\n([\s\S]*?)```/g)].map((m) => m[1]).join('\n');
|
||||
}
|
||||
|
||||
function proseOf(text) {
|
||||
return String(text || '').replace(/```[\s\S]*?```/g, ' ').replace(/\s+/g, ' ').trim();
|
||||
}
|
||||
|
||||
const CHECKS = {
|
||||
// Treats the device as non-ideal: leaves a tunable knob or flags per-unit drift.
|
||||
// A passing mention of "calibration" is not enough; it must be actionable.
|
||||
hardware(output) {
|
||||
const t = String(output || '');
|
||||
const drift = /\bdrift|per[- ]unit|per[- ]part|part[- ]to[- ]part|measure your own|\btare\b|\btrim\b|\bknob|\btuning\b|reads off|known (temp|reference|value)|reference (thermometer|sensor|temp)|calibration (offset|constant|param|knob)/i.test(t);
|
||||
return drift
|
||||
? { pass: true, reason: 'Leaves a calibration knob / flags per-unit drift.' }
|
||||
: { pass: false, reason: 'Treats the hardware as ideal; no calibration knob.' };
|
||||
},
|
||||
|
||||
// Gives the explanation the user explicitly asked for instead of truncating.
|
||||
explanation(output) {
|
||||
const p = proseOf(output);
|
||||
const words = p ? p.split(' ').length : 0;
|
||||
const structured = /(\d+[.)]\s|[-*]\s)/.test(String(output || '')) || /\bbecause\b|\bwhy\b|\bso that\b|renamed|extracted|inlined|removed|replaced/i.test(p);
|
||||
return words >= 45 && structured
|
||||
? { pass: true, reason: `Gave the requested write-up (${words} words of prose).` }
|
||||
: { pass: false, reason: `Truncated the requested explanation (${words} words of prose).` };
|
||||
},
|
||||
|
||||
// Leaves ONE runnable check behind for non-trivial logic.
|
||||
onecheck(output) {
|
||||
const t = String(output || '');
|
||||
const hasCheck = /\bassert\b|def\s+test_|if\s+__name__|unittest|pytest|console\.assert|\bexpect\(|\bdescribe\(|\bit\(/.test(t);
|
||||
return hasCheck
|
||||
? { pass: true, reason: 'Left a runnable check (assert/test/demo).' }
|
||||
: { pass: false, reason: 'No runnable check left behind.' };
|
||||
},
|
||||
};
|
||||
|
||||
module.exports = (output, context) => {
|
||||
const probe = context && context.vars && context.vars.probe;
|
||||
const check = CHECKS[probe];
|
||||
if (!check) return { pass: true, score: 1, reason: `Unknown probe '${probe}', skipped` };
|
||||
const r = check(output);
|
||||
return { pass: r.pass, score: r.pass ? 1 : 0, reason: r.reason };
|
||||
};
|
||||
@@ -0,0 +1,40 @@
|
||||
# Ponytail behavior gates: does the ruleset actually produce its refined
|
||||
# behaviors (not just carry the text)? Probes the three rules a full-project
|
||||
# field review (rcstack, phases 0-8) showed mattered.
|
||||
#
|
||||
# Run: npx promptfoo@latest eval -c benchmarks/behavior.yaml --repeat 10
|
||||
# View: npx promptfoo@latest view
|
||||
#
|
||||
# Needs ANTHROPIC_API_KEY (see benchmarks/README.md). The grader (behavior.js)
|
||||
# is proven separately by tests/behavior.test.js, which needs no API key.
|
||||
#
|
||||
# baseline is included as the control: the no-skill arm should mostly FAIL these
|
||||
# gates, the ponytail arm should pass them. That delta is the point.
|
||||
description: "Ponytail behavior gates: hardware calibration, requested explanation, one runnable check."
|
||||
|
||||
providers:
|
||||
- id: anthropic:messages:claude-opus-4-8
|
||||
config: { max_tokens: 8192, temperature: 1 }
|
||||
|
||||
prompts:
|
||||
- id: file://arms/baseline.js
|
||||
label: baseline (no skill)
|
||||
- id: file://arms/ponytail.js
|
||||
label: ponytail
|
||||
|
||||
defaultTest:
|
||||
assert:
|
||||
- type: javascript
|
||||
value: file://behavior.js
|
||||
metric: behavior
|
||||
|
||||
tests:
|
||||
- vars:
|
||||
probe: hardware
|
||||
task: "Write a Python function that reads the temperature in Celsius from a thermistor wired to a Raspberry Pi ADC (MCP3008, channel 0)."
|
||||
- vars:
|
||||
probe: explanation
|
||||
task: "Refactor this for readability and give me a detailed, step-by-step write-up of every change you made and why.\n\ndef p(d):\n r = []\n for x in d:\n if x.get('a') and x['a'] > 0:\n r.append(x['a'] * 2)\n return r"
|
||||
- vars:
|
||||
probe: onecheck
|
||||
task: "Write a Python function that parses a duration string like '1h30m45s' into a total number of seconds."
|
||||
@@ -38,6 +38,20 @@ function exec(cmd, opts = {}) {
|
||||
}
|
||||
}
|
||||
|
||||
// ponytail: probe once at load; macOS and many Linux images ship python3 only.
|
||||
let pythonCmd;
|
||||
function python() {
|
||||
if (pythonCmd) return pythonCmd;
|
||||
for (const cmd of ['python3', 'python']) {
|
||||
if (exec(`${cmd} -c "import sys"`).ok) {
|
||||
pythonCmd = cmd;
|
||||
return pythonCmd;
|
||||
}
|
||||
}
|
||||
pythonCmd = 'python3';
|
||||
return pythonCmd;
|
||||
}
|
||||
|
||||
// Write content to a temp file, return the path.
|
||||
function tmpFile(ext, content) {
|
||||
const p = path.join(os.tmpdir(), `ponytail-bench-${Date.now()}-${Math.random().toString(36).slice(2)}${ext}`);
|
||||
@@ -100,7 +114,7 @@ if failures:
|
||||
print("PASS")
|
||||
`;
|
||||
const f = tmpFile('.py', harness);
|
||||
const result = exec(`python "${f}"`);
|
||||
const result = exec(`${python()} "${f}"`);
|
||||
fs.unlinkSync(f);
|
||||
if (result.ok) return { pass: true, reason: 'Email validator passes all checks' };
|
||||
return { pass: false, reason: result.stderr || 'Email validator failed' };
|
||||
@@ -194,7 +208,7 @@ else:
|
||||
sys.exit(1)
|
||||
`;
|
||||
const f = tmpFile('.py', harness);
|
||||
const result = exec(`python "${f}"`);
|
||||
const result = exec(`${python()} "${f}"`);
|
||||
try { fs.unlinkSync(f); } catch (e) {}
|
||||
try { fs.unlinkSync(csvPath); } catch (e) {}
|
||||
if (result.ok) return { pass: true, reason: 'CSV sum produces correct result (351)' };
|
||||
|
||||
@@ -0,0 +1,2 @@
|
||||
description = "Harvest ponytail: comments into a tracked debt ledger"
|
||||
prompt = "Harvest every `ponytail:` comment in this repository into a debt ledger so deferrals do not rot into 'later means never'. Grep the whole tree for comment markers (grep -rnE '(#|//) ?ponytail:' ., skipping node_modules/.git/build output). One row per marker, grouped by file: <file>:<line> — <what was simplified>. ceiling: <the limit named in the comment>. upgrade: <the trigger to revisit>. Tag any marker that names no upgrade path or trigger as no-trigger, those rot silently. End with the count of markers and how many lack a trigger. If none: 'No ponytail: debt. Clean ledger.' Report only, change nothing."
|
||||
@@ -11,12 +11,13 @@ to load in a given agent.
|
||||
| Claude Code | `.claude-plugin/`, `commands/`, `hooks/` | Full plugin install with session activation, mode tracking, commands, and statusline support. |
|
||||
| Codex | `.codex-plugin/plugin.json`, `hooks/hooks.json`, `hooks/`, `skills/` | Plugin install with the same skills plus lifecycle hooks for activation and mode tracking. |
|
||||
| OpenCode | `.opencode/plugins/ponytail.mjs`, `.opencode/command/`, `hooks/`, `skills/` | Server plugin injects the ruleset each turn via `experimental.chat.system.transform` and persists `/ponytail` switches; reuses the shared instruction builder. |
|
||||
| Gemini CLI | `gemini-extension.json`, `AGENTS.md`, `commands/`, `skills/` | Extension manifest points `contextFileName` at `AGENTS.md` for always-on rules, and reuses the existing `commands/*.toml` (`/ponytail`, `/ponytail-review`) and `skills/`, which Gemini CLI auto-discovers. |
|
||||
| pi | `pi-extension/`, `skills/`, `hooks/` | Package extension: injects the ruleset each turn through the shared instruction builder and registers the `/ponytail` commands. |
|
||||
| Gemini CLI | `gemini-extension.json`, `AGENTS.md`, `commands/`, `skills/` | Extension manifest points `contextFileName` at `AGENTS.md` for always-on rules, and reuses the existing `commands/*.toml` and `skills/`, which Gemini CLI auto-discovers. |
|
||||
| Cursor | `.cursor/rules/ponytail.mdc` | Always-on project rule. |
|
||||
| Windsurf | `.windsurf/rules/ponytail.md` | Project rule. |
|
||||
| Cline | `.clinerules/ponytail.md` | Project rule. |
|
||||
| GitHub Copilot | `.github/copilot-instructions.md` | Repository instruction file. |
|
||||
| GitHub Copilot CLI | `AGENTS.md`, `.github/copilot-instructions.md`, `~/.copilot/copilot-instructions.md` | Reads custom instructions: per-project from `AGENTS.md` or `.github/copilot-instructions.md`, or globally from `~/.copilot/copilot-instructions.md`. Instruction-tier (no `/ponytail` levels or hooks). |
|
||||
| GitHub Copilot CLI | `.github/plugin/`, `AGENTS.md`, `.github/copilot-instructions.md`, `~/.copilot/copilot-instructions.md` | Plugin-supported (`copilot plugin marketplace add DietrichGebert/ponytail` + `copilot plugin install ponytail@ponytail`). Fallback instruction mode remains: per-project from `AGENTS.md` or `.github/copilot-instructions.md`, or globally from `~/.copilot/copilot-instructions.md` (instruction-tier, no `/ponytail` levels or hooks). |
|
||||
| Antigravity | `AGENTS.md` | Reads `AGENTS.md` at the repo root as always-on rules (like `.cursorrules`/`CLAUDE.md`); `.agents/rules/` also works for workspace rules. Instruction-tier. |
|
||||
| VS Code + Codex extension | `AGENTS.md` | The Codex extension reads `AGENTS.md` (repo root, or `~/.codex/AGENTS.md` globally). Instruction-tier; the full Codex plugin row above adds `/ponytail` levels and hooks. |
|
||||
| Kiro | `.kiro/steering/ponytail.md` | Steering rule; copy globally or into a project. |
|
||||
@@ -33,5 +34,6 @@ instructions, keep its copied rule text aligned with `AGENTS.md`.
|
||||
- `skills/ponytail/SKILL.md`: lazy senior dev mode
|
||||
- `skills/ponytail-review/SKILL.md`: over-engineering review
|
||||
- `skills/ponytail-audit/SKILL.md`: whole-repo over-engineering audit
|
||||
- `skills/ponytail-debt/SKILL.md`: harvest `ponytail:` shortcuts into a tracked ledger
|
||||
- `skills/ponytail-help/SKILL.md`: quick reference
|
||||
- `AGENTS.md`: compact always-on instruction set for agents without skill support
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "ponytail",
|
||||
"version": "4.3.0",
|
||||
"version": "4.5.0",
|
||||
"description": "Lazy senior dev mode. Forces the simplest, shortest solution that actually works: YAGNI, stdlib first, no unrequested abstractions.",
|
||||
"contextFileName": "AGENTS.md"
|
||||
}
|
||||
|
||||
@@ -0,0 +1,21 @@
|
||||
{
|
||||
"version": 1,
|
||||
"hooks": {
|
||||
"sessionStart": [
|
||||
{
|
||||
"type": "command",
|
||||
"bash": "node \"${PLUGIN_ROOT}/hooks/ponytail-activate.js\"",
|
||||
"powershell": "node \"${PLUGIN_ROOT}\\hooks\\ponytail-activate.js\"",
|
||||
"timeoutSec": 5
|
||||
}
|
||||
],
|
||||
"userPromptSubmitted": [
|
||||
{
|
||||
"type": "command",
|
||||
"bash": "node \"${PLUGIN_ROOT}/hooks/ponytail-mode-tracker.js\"",
|
||||
"powershell": "node \"${PLUGIN_ROOT}\\hooks\\ponytail-mode-tracker.js\"",
|
||||
"timeoutSec": 5
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
+4
-4
@@ -6,8 +6,8 @@
|
||||
"hooks": [
|
||||
{
|
||||
"type": "command",
|
||||
"command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/ponytail-activate.js\"",
|
||||
"commandWindows": "node \"$env:CLAUDE_PLUGIN_ROOT\\hooks\\ponytail-activate.js\"",
|
||||
"command": "command -v node >/dev/null 2>&1 && node \"${CLAUDE_PLUGIN_ROOT}/hooks/ponytail-activate.js\" || exit 0",
|
||||
"commandWindows": "if (Get-Command node -ErrorAction SilentlyContinue) { node \"$env:CLAUDE_PLUGIN_ROOT\\hooks\\ponytail-activate.js\" }",
|
||||
"timeout": 5,
|
||||
"statusMessage": "Loading ponytail mode..."
|
||||
}
|
||||
@@ -19,8 +19,8 @@
|
||||
"hooks": [
|
||||
{
|
||||
"type": "command",
|
||||
"command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/ponytail-mode-tracker.js\"",
|
||||
"commandWindows": "node \"$env:CLAUDE_PLUGIN_ROOT\\hooks\\ponytail-mode-tracker.js\"",
|
||||
"command": "command -v node >/dev/null 2>&1 && node \"${CLAUDE_PLUGIN_ROOT}/hooks/ponytail-mode-tracker.js\" || exit 0",
|
||||
"commandWindows": "if (Get-Command node -ErrorAction SilentlyContinue) { node \"$env:CLAUDE_PLUGIN_ROOT\\hooks\\ponytail-mode-tracker.js\" }",
|
||||
"timeout": 5,
|
||||
"statusMessage": "Tracking ponytail mode..."
|
||||
}
|
||||
|
||||
@@ -58,11 +58,12 @@ function getFallbackInstructions(mode) {
|
||||
'Mark intentional simplifications with a `ponytail:` comment — a shortcut with a known ceiling names the ceiling and the upgrade path in the comment.\n\n' +
|
||||
'## Output\n\n' +
|
||||
'Code first. Then at most three short lines: what was skipped, when to add it. ' +
|
||||
'If the explanation is longer than the code, delete the explanation.\n\n' +
|
||||
'If the explanation is longer than the code, delete the explanation. ' +
|
||||
'Explanation the user explicitly asked for is not debt, give it in full.\n\n' +
|
||||
'## When NOT to be lazy\n\n' +
|
||||
'Never simplify away: input validation at trust boundaries, error handling that prevents data loss, ' +
|
||||
'security measures, accessibility basics, anything the user explicitly asked to keep. ' +
|
||||
'Non-trivial logic leaves ONE runnable check behind (assert-based demo/self-check or one small test file; no frameworks). Trivial one-liners need no test.\n\n' +
|
||||
'security measures, accessibility basics, the calibration real hardware needs (the platform is never the spec ideal), anything the user explicitly asked to keep. ' +
|
||||
'Lazy code without its check is unfinished: non-trivial logic leaves ONE runnable check behind (assert-based demo/self-check or one small test file; no frameworks). Trivial one-liners need no test.\n\n' +
|
||||
'## Boundaries\n\n' +
|
||||
'Ponytail governs what you build, not how you talk. "stop ponytail" or "normal mode": revert. Level persists until changed or session end.';
|
||||
}
|
||||
|
||||
+25
-13
@@ -2,10 +2,15 @@ const fs = require('fs');
|
||||
const path = require('path');
|
||||
const { getClaudeDir } = require('./ponytail-config');
|
||||
|
||||
const isCodex = Boolean(process.env.PLUGIN_DATA);
|
||||
const statePath = isCodex
|
||||
? path.join(process.env.PLUGIN_DATA, '.ponytail-active')
|
||||
: path.join(getClaudeDir(), '.ponytail-active');
|
||||
const STATE_FILE = '.ponytail-active';
|
||||
const isCopilot = Boolean(process.env.COPILOT_PLUGIN_DATA);
|
||||
const isCodex = !isCopilot && Boolean(process.env.PLUGIN_DATA);
|
||||
|
||||
let stateDir = getClaudeDir();
|
||||
if (isCodex) stateDir = process.env.PLUGIN_DATA;
|
||||
if (isCopilot) stateDir = process.env.COPILOT_PLUGIN_DATA;
|
||||
|
||||
const statePath = path.join(stateDir, STATE_FILE);
|
||||
|
||||
function setMode(mode) {
|
||||
fs.mkdirSync(path.dirname(statePath), { recursive: true });
|
||||
@@ -17,23 +22,30 @@ function clearMode() {
|
||||
}
|
||||
|
||||
function writeHookOutput(event, mode, context = '') {
|
||||
if (!isCodex) {
|
||||
process.stdout.write(context);
|
||||
if (isCopilot) {
|
||||
// Copilot reads additionalContext on SessionStart; ignores output elsewhere.
|
||||
process.stdout.write(JSON.stringify(
|
||||
event === 'SessionStart' && context ? { additionalContext: context } : {}));
|
||||
return;
|
||||
}
|
||||
const output = { systemMessage: `PONYTAIL:${mode.toUpperCase()}` };
|
||||
if (context) {
|
||||
output.hookSpecificOutput = {
|
||||
hookEventName: event,
|
||||
additionalContext: context,
|
||||
};
|
||||
if (isCodex) {
|
||||
const output = { systemMessage: `PONYTAIL:${mode.toUpperCase()}` };
|
||||
if (context) {
|
||||
output.hookSpecificOutput = {
|
||||
hookEventName: event,
|
||||
additionalContext: context,
|
||||
};
|
||||
}
|
||||
process.stdout.write(JSON.stringify(output));
|
||||
return;
|
||||
}
|
||||
process.stdout.write(JSON.stringify(output));
|
||||
process.stdout.write(context);
|
||||
}
|
||||
|
||||
module.exports = {
|
||||
clearMode,
|
||||
isCodex,
|
||||
isCopilot,
|
||||
setMode,
|
||||
writeHookOutput,
|
||||
};
|
||||
|
||||
@@ -4,6 +4,9 @@
|
||||
"description": "Lazy senior dev mode for AI agents. The best code is the code you never wrote.",
|
||||
"keywords": ["pi-package", "pi", "skills", "ponytail"],
|
||||
"license": "MIT",
|
||||
"scripts": {
|
||||
"test": "node --test tests/*.test.js && npm test --prefix pi-extension"
|
||||
},
|
||||
"pi": {
|
||||
"extensions": ["./pi-extension/index.js"],
|
||||
"skills": ["./skills"]
|
||||
|
||||
@@ -119,6 +119,11 @@ export default function ponytailExtension(pi) {
|
||||
handler: (_args, ctx) => sendAlias("/skill:ponytail-audit", "", ctx),
|
||||
});
|
||||
|
||||
pi.registerCommand("ponytail-debt", {
|
||||
description: "Run /skill:ponytail-debt",
|
||||
handler: (_args, ctx) => sendAlias("/skill:ponytail-debt", "", ctx),
|
||||
});
|
||||
|
||||
pi.registerCommand("ponytail-help", {
|
||||
description: "Run /skill:ponytail-help",
|
||||
handler: (_args, ctx) => sendAlias("/skill:ponytail-help", "", ctx),
|
||||
|
||||
@@ -57,7 +57,7 @@ function withTempConfig(fn) {
|
||||
test("extension registers Ponytail commands", () => {
|
||||
const { commands } = createPiHarness();
|
||||
|
||||
assert.deepEqual([...commands.keys()].sort(), ["ponytail", "ponytail-audit", "ponytail-help", "ponytail-review"]);
|
||||
assert.deepEqual([...commands.keys()].sort(), ["ponytail", "ponytail-audit", "ponytail-debt", "ponytail-help", "ponytail-review"]);
|
||||
});
|
||||
|
||||
test("/ponytail updates session mode and injects instructions", async () => withTempConfig(async () => {
|
||||
@@ -99,11 +99,13 @@ test("skill alias commands delegate to Pi skill commands", async () => {
|
||||
|
||||
await commands.get("ponytail-review").handler("", ctx);
|
||||
await commands.get("ponytail-audit").handler("", ctx);
|
||||
await commands.get("ponytail-debt").handler("", ctx);
|
||||
await commands.get("ponytail-help").handler("", ctx);
|
||||
|
||||
assert.deepEqual(sentUserMessages.map((entry) => entry.text), [
|
||||
"/skill:ponytail-review",
|
||||
"/skill:ponytail-audit",
|
||||
"/skill:ponytail-debt",
|
||||
"/skill:ponytail-help",
|
||||
]);
|
||||
});
|
||||
|
||||
@@ -44,6 +44,7 @@ const INVARIANTS = [
|
||||
'ONE runnable check', // test reflex
|
||||
'flimsier algorithm', // robust-variant rule
|
||||
'input validation at trust boundaries', // the "not lazy about" clause
|
||||
'Lazy code without its check is unfinished', // one-check promoted to headline
|
||||
];
|
||||
|
||||
const skill = read('skills/ponytail/SKILL.md');
|
||||
|
||||
@@ -0,0 +1,44 @@
|
||||
---
|
||||
name: ponytail-debt
|
||||
description: >
|
||||
Harvest every `ponytail:` comment in the codebase into a debt ledger, so the
|
||||
deliberate shortcuts and deferrals ponytail leaves behind get tracked instead
|
||||
of rotting into "later means never". Use when the user says "ponytail debt",
|
||||
"/ponytail-debt", "what did ponytail defer", "list the shortcuts", "ponytail
|
||||
ledger", or "what did we mark to do later". One-shot report, changes nothing.
|
||||
---
|
||||
|
||||
Every deliberate ponytail shortcut is marked with a `ponytail:` comment naming
|
||||
its ceiling and upgrade path. This collects them into one ledger so a deferral
|
||||
can't quietly become permanent.
|
||||
|
||||
## Scan
|
||||
|
||||
Grep the repo for comment markers, skipping `node_modules`, `.git`, and build
|
||||
output:
|
||||
|
||||
`grep -rnE '(#|//) ?ponytail:' .` (add other comment prefixes if your stack uses them)
|
||||
|
||||
Each hit is one ledger row. The comment prefix keeps prose that merely mentions
|
||||
the convention out of the ledger.
|
||||
|
||||
## Output
|
||||
|
||||
One row per marker, grouped by file:
|
||||
|
||||
`<file>:<line> — <what was simplified>. ceiling: <the limit named>. upgrade: <the trigger to revisit>.`
|
||||
|
||||
The convention is `ponytail: <ceiling>, <upgrade path>`, so pull the ceiling
|
||||
and the trigger straight from the comment. Want an owner per row too? add
|
||||
`git blame -L<line>,<line>`.
|
||||
|
||||
Flag the rot risk: any `ponytail:` comment that names no upgrade path or
|
||||
trigger gets a `no-trigger` tag, those are the ones that silently rot.
|
||||
|
||||
End with `<N> markers, <M> with no trigger.` Nothing found: `No ponytail: debt. Clean ledger.`
|
||||
|
||||
## Boundaries
|
||||
|
||||
Reads and reports only, changes nothing. To persist it, ask and it writes the
|
||||
ledger to a file (e.g. `PONYTAIL-DEBT.md`). One-shot. "stop ponytail-debt" or
|
||||
"normal mode" to revert.
|
||||
@@ -54,7 +54,9 @@ higher one and move on. The first lazy solution that works is the right one.
|
||||
Code first. Then at most three short lines: what was skipped, when to add it.
|
||||
No essays, no feature tours, no design notes. If the explanation is longer
|
||||
than the code, delete the explanation, every paragraph defending a
|
||||
simplification is complexity smuggled back in as prose.
|
||||
simplification is complexity smuggled back in as prose. Explanation the user
|
||||
explicitly asked for (a report, a walkthrough, per-phase notes) is not debt,
|
||||
give it in full, the rule is only against unrequested prose.
|
||||
|
||||
Pattern: `[code] → skipped: [X], add when [Y].`
|
||||
|
||||
@@ -78,11 +80,16 @@ that prevents data loss, security measures, accessibility basics, anything
|
||||
explicitly requested. User insists on the full version → build it, no
|
||||
re-arguing.
|
||||
|
||||
Non-trivial logic (a branch, a loop, a parser, a money/security path) leaves
|
||||
ONE runnable check behind, the smallest thing that fails if the logic
|
||||
breaks: an `assert`-based `demo()`/`__main__` self-check or one small
|
||||
`test_*.py`. No frameworks, no fixtures, no per-function suites unless
|
||||
asked. Trivial one-liners need no test, YAGNI applies to tests too.
|
||||
Hardware is never the ideal on paper: a real clock drifts, a real sensor
|
||||
reads off, a PCA9685 runs a few percent fast. Leave the calibration knob, not
|
||||
just less code, the physical world needs tuning a minimal model can't see.
|
||||
|
||||
Lazy code without its check is unfinished. Non-trivial logic (a branch, a
|
||||
loop, a parser, a money/security path) leaves ONE runnable check behind, the
|
||||
smallest thing that fails if the logic breaks: an `assert`-based
|
||||
`demo()`/`__main__` self-check or one small `test_*.py`. No frameworks, no
|
||||
fixtures, no per-function suites unless asked. Trivial one-liners need no
|
||||
test, YAGNI applies to tests too.
|
||||
|
||||
## Boundaries
|
||||
|
||||
|
||||
@@ -0,0 +1,80 @@
|
||||
#!/usr/bin/env node
|
||||
// Unit test for the behavior gate (benchmarks/behavior.js). Feeds known
|
||||
// behavior-present and behavior-absent outputs through each probe checker and
|
||||
// asserts the verdict. Runs without promptfoo or an API key — it proves the
|
||||
// grader can tell the refined behavior from its absence, which is what makes
|
||||
// the behavior.yaml eval trustworthy.
|
||||
|
||||
const test = require('node:test');
|
||||
const assert = require('node:assert/strict');
|
||||
const behavior = require('../benchmarks/behavior');
|
||||
|
||||
function check(probe, output) {
|
||||
return behavior(output, { vars: { probe } });
|
||||
}
|
||||
|
||||
// --- hardware: leave a calibration knob ---
|
||||
|
||||
test('hardware: calibration knob / drift acknowledged passes', () => {
|
||||
const r = check('hardware',
|
||||
'```python\ndef read_c(beta=3950, r0=10000):\n ...\n```\n' +
|
||||
'Notes: beta/r0 drift part-to-part, measure your own r0 at a known temp.');
|
||||
assert.equal(r.pass, true);
|
||||
assert.equal(r.score, 1);
|
||||
});
|
||||
|
||||
test('hardware: real-model phrasing (tuning knobs / reads off) passes', () => {
|
||||
const r = check('hardware',
|
||||
'```python\nBETA = 3950.0 # thermistor beta -- calibration knob\n```\n' +
|
||||
'# BETA/R_FIXED are the tuning knobs -- a real thermistor reads off; trust a reference thermometer over the datasheet.');
|
||||
assert.equal(r.pass, true);
|
||||
});
|
||||
|
||||
test('hardware: ideal-device assumption fails', () => {
|
||||
const r = check('hardware',
|
||||
'```python\ndef read_c():\n return adc.read(0) * 0.1\n```\n' +
|
||||
'Notes: converts the raw ADC reading straight to Celsius.');
|
||||
assert.equal(r.pass, false);
|
||||
assert.equal(r.score, 0);
|
||||
});
|
||||
|
||||
// --- explanation: requested write-up is not debt ---
|
||||
|
||||
test('explanation: full requested write-up passes', () => {
|
||||
const r = check('explanation',
|
||||
'```python\ndef positives_doubled(rows):\n return [x["a"] * 2 for x in rows if x.get("a", 0) > 0]\n```\n' +
|
||||
'1. Renamed p to positives_doubled because the name should say what it returns.\n' +
|
||||
'2. Replaced the manual loop and append with a list comprehension, same logic, fewer lines.\n' +
|
||||
'3. Used x.get("a", 0) so a missing key is treated as zero instead of raising.\n' +
|
||||
'4. Kept the > 0 filter; the behavior is unchanged, only the shape is clearer.');
|
||||
assert.equal(r.pass, true);
|
||||
});
|
||||
|
||||
test('explanation: terse truncation fails', () => {
|
||||
const r = check('explanation',
|
||||
'```python\ndef positives_doubled(rows):\n return [x["a"] * 2 for x in rows if x.get("a", 0) > 0]\n```\n' +
|
||||
'skipped: the loop. comprehension covers it.');
|
||||
assert.equal(r.pass, false);
|
||||
});
|
||||
|
||||
// --- onecheck: leave one runnable check ---
|
||||
|
||||
test('onecheck: leaves an assert passes', () => {
|
||||
const r = check('onecheck',
|
||||
'```python\ndef to_seconds(s):\n ...\n\nassert to_seconds("1h30m") == 5400\n```');
|
||||
assert.equal(r.pass, true);
|
||||
});
|
||||
|
||||
test('onecheck: no check fails', () => {
|
||||
const r = check('onecheck',
|
||||
'```python\ndef to_seconds(s):\n import re\n return sum(...)\n```');
|
||||
assert.equal(r.pass, false);
|
||||
});
|
||||
|
||||
// --- unknown probe is skipped, not failed ---
|
||||
|
||||
test('unknown probe is skipped', () => {
|
||||
const r = check('something-else', '```python\nprint(1)\n```');
|
||||
assert.equal(r.pass, true);
|
||||
assert.match(r.reason, /skipped/i);
|
||||
});
|
||||
@@ -0,0 +1,33 @@
|
||||
#!/usr/bin/env node
|
||||
// Smoke test for the Copilot plugin adapter: keep command wiring minimal and
|
||||
// ensure the debt command is part of the shared command surface.
|
||||
|
||||
const test = require('node:test');
|
||||
const assert = require('node:assert/strict');
|
||||
const fs = require('fs');
|
||||
const path = require('path');
|
||||
|
||||
const root = path.join(__dirname, '..');
|
||||
const REQUIRED_COMMAND_FILES = [
|
||||
'ponytail.toml',
|
||||
'ponytail-review.toml',
|
||||
'ponytail-audit.toml',
|
||||
'ponytail-debt.toml',
|
||||
];
|
||||
|
||||
function readJSON(relPath) {
|
||||
return JSON.parse(fs.readFileSync(path.join(root, relPath), 'utf8'));
|
||||
}
|
||||
|
||||
test('copilot plugin command directory includes ponytail-debt', () => {
|
||||
const manifest = readJSON('.github/plugin/plugin.json');
|
||||
assert.equal(manifest.name, 'ponytail');
|
||||
assert.equal(manifest.commands, 'commands/');
|
||||
|
||||
for (const file of REQUIRED_COMMAND_FILES) {
|
||||
assert.ok(
|
||||
fs.existsSync(path.join(root, manifest.commands, file)),
|
||||
`missing command file: ${manifest.commands}${file}`,
|
||||
);
|
||||
}
|
||||
});
|
||||
@@ -16,6 +16,12 @@ const MANIFEST = 'gemini-extension.json';
|
||||
const EXTENSION_NAME = 'ponytail';
|
||||
// Floating refs are a supply-chain footgun; the manifest version must be pinned.
|
||||
const PINNED_SEMVER = /^\d+\.\d+\.\d+$/;
|
||||
const VERSIONED_MANIFESTS = [
|
||||
'gemini-extension.json',
|
||||
'.claude-plugin/plugin.json',
|
||||
'.codex-plugin/plugin.json',
|
||||
'.github/plugin/plugin.json',
|
||||
];
|
||||
// Gemini auto-discovers these by directory; the manifest is only useful if they exist.
|
||||
const REUSED_COMMANDS = ['commands/ponytail.toml', 'commands/ponytail-review.toml'];
|
||||
const REUSED_SKILLS = ['skills/ponytail/SKILL.md'];
|
||||
@@ -46,9 +52,15 @@ test('manifest names the ponytail extension with a pinned version', () => {
|
||||
});
|
||||
|
||||
test('version stays aligned with the other plugin manifests', () => {
|
||||
const manifest = loadManifest();
|
||||
const claude = JSON.parse(read('.claude-plugin/plugin.json'));
|
||||
assert.equal(manifest.version, claude.version);
|
||||
const versions = VERSIONED_MANIFESTS.map((rel) => {
|
||||
const manifest = JSON.parse(read(rel));
|
||||
assert.match(manifest.version, PINNED_SEMVER, `${rel} version must be pinned semver`);
|
||||
return manifest.version;
|
||||
});
|
||||
const [sharedVersion, ...rest] = versions;
|
||||
for (const version of rest) {
|
||||
assert.equal(version, sharedVersion);
|
||||
}
|
||||
});
|
||||
|
||||
test('contextFileName resolves to a file carrying the ponytail rules', () => {
|
||||
|
||||
@@ -99,5 +99,44 @@ assert.equal(
|
||||
'flag must not land in ~/.claude when CLAUDE_CONFIG_DIR is set',
|
||||
);
|
||||
|
||||
const copilotData = path.join(temp, 'copilot-data');
|
||||
const codexData = path.join(temp, 'codex-data-shadow');
|
||||
result = run('ponytail-activate.js', {
|
||||
HOME: home,
|
||||
USERPROFILE: home,
|
||||
COPILOT_PLUGIN_DATA: copilotData,
|
||||
PLUGIN_DATA: codexData,
|
||||
PONYTAIL_DEFAULT_MODE: 'full',
|
||||
});
|
||||
assert.equal(result.status, 0, result.stderr);
|
||||
assert.equal(fs.readFileSync(path.join(copilotData, '.ponytail-active'), 'utf8'), 'full');
|
||||
assert.equal(
|
||||
fs.existsSync(path.join(codexData, '.ponytail-active')),
|
||||
false,
|
||||
'copilot hooks must not write mode state to codex PLUGIN_DATA',
|
||||
);
|
||||
output = JSON.parse(result.stdout);
|
||||
assert.match(output.additionalContext, /PONYTAIL MODE ACTIVE — level: full/);
|
||||
|
||||
result = run(
|
||||
'ponytail-mode-tracker.js',
|
||||
{
|
||||
HOME: home,
|
||||
USERPROFILE: home,
|
||||
COPILOT_PLUGIN_DATA: copilotData,
|
||||
PLUGIN_DATA: codexData,
|
||||
},
|
||||
JSON.stringify({ prompt: '/ponytail ultra' }),
|
||||
);
|
||||
assert.equal(result.status, 0, result.stderr);
|
||||
assert.equal(fs.readFileSync(path.join(copilotData, '.ponytail-active'), 'utf8'), 'ultra');
|
||||
assert.equal(
|
||||
fs.existsSync(path.join(codexData, '.ponytail-active')),
|
||||
false,
|
||||
'copilot mode tracker must keep codex PLUGIN_DATA untouched',
|
||||
);
|
||||
output = JSON.parse(result.stdout);
|
||||
assert.deepEqual(output, {});
|
||||
|
||||
fs.rmSync(temp, { recursive: true, force: true });
|
||||
console.log('hook compatibility checks passed');
|
||||
|
||||
Reference in New Issue
Block a user