ripplo 0.10.0 → 0.11.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +105 -47
- package/dist/assets/rrweb-replay.js +1 -1
- package/dist/assets/rrweb.js +1 -1
- package/dist/capture-worker.js +20 -14
- package/dist/chunk-2TA4WDEE.js +4 -0
- package/dist/{chunk-5E62BCS7.js → chunk-47LLHHJH.js} +2 -2
- package/dist/chunk-4LXIRKM7.js +4 -0
- package/dist/chunk-5HFJIZLI.js +4 -0
- package/dist/chunk-5HZ2LDFS.js +83 -0
- package/dist/chunk-5VXXRMJU.js +354 -0
- package/dist/chunk-6U2LNGSV.js +51 -0
- package/dist/{chunk-LL4HUOJP.js → chunk-6WFJZ5L6.js} +1 -1
- package/dist/chunk-7JKCHASU.js +4 -0
- package/dist/{chunk-WNAVYV4P.js → chunk-AXROBTLA.js} +1 -1
- package/dist/chunk-BGY5F3IU.js +5 -0
- package/dist/{chunk-IPSXNIXC.js → chunk-C7SV6AR2.js} +4 -4
- package/dist/chunk-CI6273ZU.js +107 -0
- package/dist/chunk-D6TS77JP.js +8 -0
- package/dist/{chunk-QAR7FZO3.js → chunk-EEOTA6M4.js} +1 -1
- package/dist/{chunk-UDPKOYZT.js → chunk-EQORLKHG.js} +1 -1
- package/dist/chunk-F4P36OMG.js +9 -0
- package/dist/chunk-G6J2WIHJ.js +4 -0
- package/dist/{chunk-LOEAZGYO.js → chunk-HEOMRXZE.js} +1 -1
- package/dist/{chunk-7W237JFM.js → chunk-JS3DLVVI.js} +1 -1
- package/dist/{chunk-TPHOSZAK.js → chunk-KH4QH23U.js} +1 -1
- package/dist/{chunk-43C7VPGA.js → chunk-LWMXGWS2.js} +1 -1
- package/dist/{chunk-YQ2RBEOJ.js → chunk-PXXURBGC.js} +2 -2
- package/dist/{chunk-OAU4HUD2.js → chunk-PYDYI3AA.js} +2 -2
- package/dist/{chunk-R3DZ6JPY.js → chunk-RIASQHPG.js} +1 -1
- package/dist/chunk-ROO3KF74.js +6 -0
- package/dist/chunk-SXVWB7TZ.js +6 -0
- package/dist/{chunk-4OSYMIH6.js → chunk-UC54UNEX.js} +1 -1
- package/dist/{chunk-5X4M4MTG.js → chunk-UFXH75WD.js} +3 -3
- package/dist/chunk-WAGXAEB4.js +13 -0
- package/dist/{chunk-CEVQ5RNC.js → chunk-WCMWNWNM.js} +2 -2
- package/dist/{chunk-AGK6XOX2.js → chunk-XAMVRZJH.js} +2 -2
- package/dist/chunk-ZHDR7LXB.js +56 -0
- package/dist/chunk-ZM2UPFCR.js +7 -0
- package/dist/{cli-error-AHNJULLG.js → cli-error-6PUIWNIT.js} +1 -1
- package/dist/{compile-write-OLQOR3OK.js → compile-write-N3PWYUKE.js} +1 -1
- package/dist/daemon-SAV2CLXD.js +4 -0
- package/dist/daemon-X77GWCFM.js +152 -0
- package/dist/{daemon-lock-OAARBZ4O.js → daemon-lock-RPKO5SNE.js} +1 -1
- package/dist/dsl-loader-WPAKMON7.js +4 -0
- package/dist/dsl-typecheck-worker.js +6 -0
- package/dist/{exit-plan-gate-CJ3IXWTN.js → exit-plan-gate-44YWEKYS.js} +1 -1
- package/dist/hook.js +1 -1
- package/dist/index.js +211 -260
- package/dist/{plan-reminder-EPCNBFY3.js → plan-reminder-YX375SPX.js} +1 -1
- package/dist/post-edit-7W6AHXE6.js +4 -0
- package/dist/post-edit-analyze-PO54GIZ3.js +4 -0
- package/dist/post-edit-flag-stubs-G3G2FO6Z.js +4 -0
- package/dist/pre-bash-run-gate-MIEM2DBB.js +4 -0
- package/dist/pre-edit-C4MGURNO.js +4 -0
- package/dist/pre-edit-ripplo-skill-gate-A6ETC3QN.js +4 -0
- package/dist/pre-edit-scope-gate-M5IQSVGF.js +4 -0
- package/dist/{pre-edit-watch-gate-BUFWLXR3.js → pre-edit-watch-gate-ORQP7MSW.js} +1 -1
- package/dist/prompt-submit-YOKR2RQN.js +4 -0
- package/dist/scope-reminder-A6GVTTVE.js +4 -0
- package/dist/session-preamble-IZQPIWST.js +4 -0
- package/dist/status-HOJW4C3O.js +4 -0
- package/dist/{stop-enforce-4XV6LK7Z.js → stop-enforce-JT3SWBU4.js} +9 -9
- package/dist/tasks-reminder-TDWPD3KV.js +4 -0
- package/dist/{track-skill-load-CJ74GD3Q.js → track-skill-load-SXSDMHFO.js} +1 -1
- package/dist/{track-skill-prompt-YSB6OOQN.js → track-skill-prompt-7N4TQAD2.js} +1 -1
- package/package.json +3 -5
- package/dist/chunk-26A42N75.js +0 -55
- package/dist/chunk-44GHUVW6.js +0 -8
- package/dist/chunk-67YR3QHA.js +0 -6
- package/dist/chunk-6NKSEWP6.js +0 -224
- package/dist/chunk-6TCK75ER.js +0 -83
- package/dist/chunk-73TKORK6.js +0 -8
- package/dist/chunk-CB74TAUC.js +0 -5
- package/dist/chunk-FXCBWBN5.js +0 -4
- package/dist/chunk-GOZWOCTE.js +0 -7
- package/dist/chunk-IONMYZ3K.js +0 -4
- package/dist/chunk-LB65USNP.js +0 -73
- package/dist/chunk-M3CXHDFV.js +0 -9
- package/dist/chunk-MOI4L3EX.js +0 -4
- package/dist/chunk-N2OBRCPQ.js +0 -6
- package/dist/chunk-OWN4P2K7.js +0 -4
- package/dist/chunk-SNU66GSR.js +0 -4
- package/dist/chunk-VDAFHS7J.js +0 -7
- package/dist/chunk-VOZOP7MQ.js +0 -55
- package/dist/daemon-BJAGK2Q3.js +0 -152
- package/dist/daemon-H4P5PCVH.js +0 -4
- package/dist/dsl-loader-LXH6PUY5.js +0 -4
- package/dist/post-edit-ZVCYZ62V.js +0 -4
- package/dist/post-edit-analyze-J2H3I3IO.js +0 -4
- package/dist/post-edit-flag-stubs-E22KT2LD.js +0 -4
- package/dist/pre-bash-run-gate-B42YNDQF.js +0 -4
- package/dist/pre-edit-TEN3AFRK.js +0 -4
- package/dist/pre-edit-ripplo-skill-gate-QHUD7QGU.js +0 -4
- package/dist/pre-edit-scope-gate-2YIFSEDY.js +0 -4
- package/dist/prompt-submit-DJFWNGYC.js +0 -4
- package/dist/scope-reminder-DIDCHDAA.js +0 -4
- package/dist/session-preamble-ZYVRDSGA.js +0 -4
- package/dist/status-FDM2RK37.js +0 -4
- package/dist/tasks-reminder-SDS6RNLP.js +0 -4
|
@@ -1,4 +0,0 @@
|
|
|
1
|
-
#!/usr/bin/env node
|
|
2
|
-
import { createRequire as __ripploCreateRequire } from "node:module";
|
|
3
|
-
const require = globalThis.require ?? __ripploCreateRequire(import.meta.url);
|
|
4
|
-
import{a as e}from"./chunk-7WZ3VIUU.js";import{c as t}from"./chunk-KOKEEAEF.js";import"./chunk-KMZ3L5YA.js";var s="# Ripplo \u2014 always-on session context\n\nEvery user-facing change in this repo ships with a deterministic, backend-aware test that proves it works end-to-end.\n\n## Load the right skill before acting \u2014 this is critical\n\nThe skills below carry the procedural detail you need to do Ripplo work correctly: entity/given modeling, parallel-isolation in engine impls, backend state assertions, scope discipline, artifact-read order on failures, parallelization patterns. **None of that is reproduced in this preamble** \u2014 only the always-on guardrails are. If you act on a Ripplo task without loading the matching skill, you will skip rules that exist to prevent specific past failure modes (cross-run data leakage, \"passing\" tests that never asserted backend state, etc.).\n\nMatch the task to a skill from the triage table \u2014 if unsure between two, load both. If completely unsure, load `/ripplo:discover` or `/ripplo:create`. Loading is cheap. Acting under-informed is not.\n\n**This is a hard requirement, not a suggestion.** Do NOT run `npx ripplo` commands, edit `.ripplo/` files, or reason about how Ripplo behaves before loading the matching skill. Agents that skip this consistently misuse the CLI, invent flags that don't exist, and hold wrong expectations about compile, run, facts, scope, and the explorer \u2014 every one of those failure modes traces back to acting without the skill loaded. The skill is the source of truth for its area. When in doubt, load it first.\n\nThe skills share one mental model \u2014 how Ripplo thinks (workflows declare state, facts carry across workflows, what compile/run/explorer each enforce), and the rules below are consequences of it. It loads automatically the first time you load a Ripplo skill this session, so load a skill before acting.\n\n## Skill triage\n\n- Load `/ripplo:setup` skill for instructions on initializing Ripplo in a project; `npx ripplo doctor` reports the engine endpoint missing.\n- Load `/ripplo:discover` skill for instructions on planning/stubbing test coverage for a new project or new feature area.\n- Load `/ripplo:create` skill for instructions on authoring a single workflow for a user flow.\n- Load `/ripplo:run` skill for instructions on executing tests, managing the testing scope this session is responsible for, diagnosing a failed run (read artifacts in `.ripplo/debug/<runId>/` before re-running), and filing caught app bugs.\n- Load `/ripplo:tasks` skill for instructions on picking up tasks \u2014 open-ended requests users anchor to a replay frame and element (fix a bug, change behavior, extend or write a workflow, ask a question) and background-explorer findings, which arrive as tasks of their own. It routes the request, lets you ask the user back with `clarify`, and for app changes enforces proof with an exact run, frame, and element. Load it whenever a tasks reminder fires, the user points you at a task or finding, or before any `npx ripplo tasks` command.\n\n## Universal rules\n\n- **Two background processes must be running before feature work.** (1) The app's dev server, so the app is reachable; (2) `npx ripplo daemon` (run `/ripplo:start` to spawn it, or invoke it directly via Bash with `run_in_background`), so the dev session is live. Without the daemon, dev-mode hooks don't arm (`ripplo run` will auto-start one if absent). Without the dev server, runs fail when they try to hit the app. `npx ripplo doctor` reports both. Manage the daemon with `npx ripplo daemon status` and `npx ripplo daemon stop` (stale holder, CLI update). Switch executor live with `npx ripplo executor <local|cloud>` \u2014 no restart. Don't use `daemon restart` as an agent \u2014 the start half never returns; stop, then respawn in the background.\n- **Two funnels.** Definitions \u2192 `createRipplo({ entities, singletons, workflows })` in `.ripplo/index.ts`. Implementations \u2192 `createEngine(ripplo, { entities: impls, singletons })` in your app server's `test/engine.ts` \u2014 one `seed`/`read` impl per entity. Never call either elsewhere. TS enforces exhaustiveness across both.\n- **\"Done\" = app code delivers the behavior AND a passing test proves it.** Both halves. Shipping without a test isn't done; writing a test against broken UI/API isn't done.\n- **Scope is your job.** For any non-trivial change, enumerate every flow it could affect and either `scope add` existing workflows or stub new ones with `workflow(\"Intent\")` (no body). Don't wait to be told.\n- **`scope remove` is never for size/effort.** Valid only when an item is genuinely out of scope (wrong flow, duplicate, user said \"not this session,\" feature cut). \"Too many stubs\" \u2192 parallelize with subagents. Don't present \"implement vs. remove\" as a neutral A/B.\n- **Stub gates are not a question.** When `stop-enforce` blocks on unimplemented stubs, implement them \u2014 don't ask the user \"implement or defer?\", don't pause hooks to skip them. The fix isn't done until the test is. New scaffolding (entity, given, engine impl) is in-scope work, not follow-up.\n- **You control the hooks \u2014 use it for rapid iteration, never to dodge work.** `npx ripplo hooks pause` silences pre-edit gates and stop-enforce, `npx ripplo hooks resume` re-arms them. Pause when a user asks you to iterate fast on a feature and the checks are noise mid-loop. When you pause, say so, and before you call the work done, resume and run the full check clean. Pausing to escape a failing test or an unimplemented stub is the one thing it's not for.\n- **Keep the explorer running all session.** The background explorer walks composed paths no workflow author wrote \u2014 it fills coverage gaps and catches bugs that only surface when actions combine. It is the third gate, not an extra. Check or toggle it with `npx ripplo explore [on|off]` (`--trail` sets path depth, `--workers` sets concurrency). Findings arrive as tasks \u2014 but the task watcher never fires on them, so poll `npx ripplo tasks list` to see new findings. Triage with `/ripplo:tasks` \u2014 an open finding blocks the session end like any task. Leave it on.\n- **A workflow is a user journey, not a single-mutation snippet.** One user intent, the real click path from a natural entry point, as many mutations as the intent takes \u2014 with `when` branches wherever seeded state changes an outcome along the path. Authoring method lives in `/ripplo:create`.\n- **Backend assertions are mandatory on mutations.** Every mutation step carries an `Entity.created/updated/deleted` in its `.expect(...)` \u2014 Ripplo checks your app's state against what the test expected. A UI-only check on a mutation ships the bug as green.\n- **Never weaken a test to make it pass.** No `contains`/regex for exact text, no removed assertions, no fabricated locators. App lacks an accessible name \u2192 add one to the app, don't fall back to `testId()`. App bug \u2192 report with evidence.\n- **Artifacts first, re-run last.** Failed runs write `.ripplo/debug/<runId>/behavior.jsonl` \u2014 a causal stream of actions, assertions, rrweb DOM, console, network, and server spans \u2014 and the run output renders the findings. Read them. Never pipe `ripplo run` through `grep`/`tail`/`head`. Form a hypothesis citing an event, make one change, re-run once.\n- **`.ripplo/ripplo.lock` is committed, never hand-edited.** `ripplo compile` regenerates it. Pre-commit runs `ripplo compile --check`.\n- **Scratch files live in `.ripplo/.local/`.** Never loose in `.ripplo/`.\n- **Worktrees are self-contained.** Each worktree has its own `.ripplo/` checkout, DevSession, scope, and debug artifacts. Auth and projectId are shared globally. Env files (typically gitignored) won't carry over to a fresh worktree \u2014 copy from main or point at a shared file. **If sibling worktrees run dev servers on different ports, the worktree's env file must update both `RIPPLO_APP_URL` and `RIPPLO_ENGINE_URL` to match the port that worktree's dev server is bound to** (e.g. main on `:3000`, this worktree on `:3001` \u2192 set `RIPPLO_APP_URL=http://localhost:3001` and `RIPPLO_ENGINE_URL=http://localhost:3001/ripplo` in the worktree's env file). Mismatched ports = `npx ripplo daemon` talks to the wrong server, runs silently fail or hit the sibling worktree's app.\n- **DSL locators are semantic.** Use `role`/`button`/`textbox`/`heading`/`link`; `testId` only when no ARIA role exists.\n- **New backend state?** Add an `entity(...)` in `.ripplo/entities/` and a `seed`/`read` impl in your app's engine funnel (TS flags the missing impl).\n- **Tasks demand exact proof, never hand-waving.** Resolving a task (`npx ripplo tasks resolve`) requires a run that exercises the broken condition plus a frame and element that show the fix \u2014 a red\u2192green assertion or before/after snapshots you Read, anchored on the resolving comment. Never conclude \"fixed\" from the diff, a toast, or a log string. If a run can't yet reach the broken condition, extend or write the workflow that does \u2014 don't resolve without proof. Load `/ripplo:tasks` for the loop.\n- **Know the task lifecycle.** A task is **open** (needs you), **needs clarification** (waiting on the user after your `clarify` \u2014 not your move), **resolved**, or **dismissed**. The task watcher (armed by `/ripplo:start`) wakes you live on a new user task, a reopen, or a user reply, even while idle \u2014 never on an explorer finding. Findings only show up when you poll `npx ripplo tasks list` (or at a stop-hook reminder). A **reopen** means your earlier fix didn't hold \u2014 revisit it, don't treat it as a fresh request. If the user resolves or dismisses a task you were working, it's no longer relevant \u2014 stop working it (you find out at your next stop, not via a wake). While hooks are on, you cannot end the session with a task open \u2014 clear each with resolve, clarify, or dismiss. Load `/ripplo:tasks` for the loop.\n\n## Key files\n\n- `.ripplo/index.ts` \u2014 `createRipplo` call.\n- `.ripplo/{entities,singletons,workflows}/index.ts` \u2014 registry aggregators. `.ripplo/givens.ts` + feature `givens.ts` \u2014 given builders.\n- `.ripplo/project.json` \u2014 project id + env-file pointers.\n- `<app>/src/test/engine.ts` \u2014 single impl funnel via `createEngine`.\n- `/ripplo:create` skill \u2014 DSL reference (entities, givens, workflows, backend assertions). Full primitive catalog at `node_modules/@ripplo/testing/DSL.md`.\n",r=t("SessionStart",o=>{if(e(o.cwd))return{hookSpecificOutput:{additionalContext:s,hookEventName:"SessionStart"}}});export{r as sessionPreambleHook};
|
package/dist/status-FDM2RK37.js
DELETED
|
@@ -1,4 +0,0 @@
|
|
|
1
|
-
#!/usr/bin/env node
|
|
2
|
-
import { createRequire as __ripploCreateRequire } from "node:module";
|
|
3
|
-
const require = globalThis.require ?? __ripploCreateRequire(import.meta.url);
|
|
4
|
-
import{a}from"./chunk-CEVQ5RNC.js";import"./chunk-QAR7FZO3.js";import"./chunk-IONMYZ3K.js";import"./chunk-R4ZTRVDQ.js";import"./chunk-73TKORK6.js";import"./chunk-MHNGR6M7.js";import"./chunk-FXCBWBN5.js";import"./chunk-67YR3QHA.js";import"./chunk-IPSXNIXC.js";import"./chunk-LOEAZGYO.js";import"./chunk-5X4M4MTG.js";import"./chunk-6TCK75ER.js";import"./chunk-26A42N75.js";import"./chunk-NNH3YVVO.js";import"./chunk-KMZ3L5YA.js";export{a as statusCommand};
|
|
@@ -1,4 +0,0 @@
|
|
|
1
|
-
#!/usr/bin/env node
|
|
2
|
-
import { createRequire as __ripploCreateRequire } from "node:module";
|
|
3
|
-
const require = globalThis.require ?? __ripploCreateRequire(import.meta.url);
|
|
4
|
-
import{a}from"./chunk-AGK6XOX2.js";import"./chunk-CB74TAUC.js";import"./chunk-5E62BCS7.js";import"./chunk-OQ6KNYPG.js";import"./chunk-7W237JFM.js";import"./chunk-7WZ3VIUU.js";import"./chunk-TPHOSZAK.js";import"./chunk-FEHVIHVA.js";import"./chunk-R3DZ6JPY.js";import"./chunk-MHNGR6M7.js";import"./chunk-IPSXNIXC.js";import"./chunk-LOEAZGYO.js";import"./chunk-NNH3YVVO.js";import"./chunk-KMZ3L5YA.js";export{a as tasksReminder};
|