wayform 0.3.1 → 0.4.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.
@@ -0,0 +1,86 @@
1
+ /**
2
+ * The wayform-build skill, embedded as a string because the npm package ships
3
+ * only dist/. `wayform init --remote` writes it into each wired client's skills dir.
4
+ */
5
+ import fs from "node:fs";
6
+ import path from "node:path";
7
+ export const BUILD_SKILL_NAME = "wayform-build";
8
+ const SKILL_DIRS = {
9
+ claude: ".claude/skills",
10
+ // Cursor reads project skills from .agents/skills, so it shares Codex's copy.
11
+ cursor: ".agents/skills",
12
+ codex: ".agents/skills",
13
+ };
14
+ /** Repo-relative install path of the skill for a client. */
15
+ export function skillPath(client) {
16
+ return `${SKILL_DIRS[client]}/${BUILD_SKILL_NAME}/SKILL.md`;
17
+ }
18
+ export const BUILD_SKILL_MD = `---
19
+ name: wayform-build
20
+ description: Build a Wayform plan end to end with subagents. Use ONLY when asked to build, implement, execute or resume a specific Wayform plan by number (#N), or on /wayform-build. Not for general Wayform questions, memory lookups, or guard/hook behaviour.
21
+ ---
22
+
23
+ # Build a Wayform plan
24
+
25
+ You are the orchestrator. Use subagents for this: every checklist task goes to its own subagent, and you
26
+ coordinate, verify and record. The request names a plan number (#N) and usually a project. If no project
27
+ is named, use the project from the Wayform session-start briefing; if there is none, ask which project.
28
+
29
+ ## 1. Load and claim the plan
30
+
31
+ - \`read_plan(project, plan="#N")\`.
32
+ - State \`active\`: call \`transition_plan(project, plan="#N", to="building", agent="<your client: claude-code | cursor | codex>")\`.
33
+ - State \`building\`: you are resuming. Skip the transition; unchecked items are what is left.
34
+ - Any other state (draft, shipped, superseded): stop. Say the plan must be approved (active) first.
35
+
36
+ ## 2. Split the checklist into tasks
37
+
38
+ - Each unchecked \`- [ ]\` item is a task. Skip checked \`- [x]\` items.
39
+ - Mark each task independent or ordered. A task is ordered when it needs another task's output (a file,
40
+ an interface, a migration). When unsure, treat it as ordered.
41
+ - Show the user the task list and the order in one short message, then continue without waiting.
42
+
43
+ ## 3. Run each task in a subagent
44
+
45
+ For each task, in order (independent tasks in parallel: several subagent launches in one message):
46
+
47
+ 1. \`task_brief(project, plan="#N", task="<the checklist item text, verbatim>")\`.
48
+ 2. Launch one subagent. Its prompt is, in this order:
49
+ - the task brief, **verbatim**;
50
+ - the task text, plus any file or interface an earlier task produced that this one needs;
51
+ - "Do not launch subagents of your own. When done, report the files you changed, the tests you ran and
52
+ their result, and any decision in the brief you could not honour."
53
+ 3. Subagents never launch further subagents. Do not ask them to.
54
+
55
+ If a subagent reports it could not honour a decision, do not work around it: stop that task and tell the user
56
+ which decision and why.
57
+
58
+ If a subagent reports that Wayform blocked an action, ask the user whether to go ahead. Only if they explicitly confirm, call guard_allow(project, ticket) with the ticket from the block message and re-run that task.
59
+
60
+ ## 4. Verify and record each task
61
+
62
+ - Check the work yourself: run the tests, lint or build the plan names for that item (or the project's
63
+ usual test command). Read the diff. A subagent's "done" is not evidence.
64
+ - Passing: tick that item. \`read_plan\` again; the plan markdown is everything after the first \`---\` line of its output, and
65
+ the header line shows its \`rev\`. Change only that \`- [ ]\` to \`- [x]\`, then
66
+ \`edit_plan(project, plan="#N", body=<that markdown>, base_rev=<rev>)\`. If it reports the plan changed, re-read and retry.
67
+ - Failing: send the subagent (or a new one with the same brief) the failure; at most two retries, then stop
68
+ and report.
69
+
70
+ ## 5. Finish
71
+
72
+ - Report to the user: tasks done, tests run and their results, anything skipped or blocked.
73
+ - Do not commit, push or merge unless the user asks.
74
+ - After the work merges: \`transition_plan(project, plan="#N", to="shipped", commit_sha=<merge sha>,
75
+ decisions=[…])\`. Each decision is one self-contained fact with its "because", only the ones this build
76
+ actually settled.
77
+ `;
78
+ /** Write (overwrite) the skill into a repo. Wayform-managed: init refreshes it. */
79
+ export function installBuildSkill(cwd, client) {
80
+ const rel = skillPath(client);
81
+ const file = path.join(cwd, rel);
82
+ fs.mkdirSync(path.dirname(file), { recursive: true });
83
+ fs.writeFileSync(file, BUILD_SKILL_MD);
84
+ return rel;
85
+ }
86
+ //# sourceMappingURL=build-skill.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"build-skill.js","sourceRoot":"","sources":["../src/build-skill.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAI7B,MAAM,CAAC,MAAM,gBAAgB,GAAG,eAAe,CAAC;AAEhD,MAAM,UAAU,GAAgC;IAC9C,MAAM,EAAE,gBAAgB;IACxB,8EAA8E;IAC9E,MAAM,EAAE,gBAAgB;IACxB,KAAK,EAAE,gBAAgB;CACxB,CAAC;AAEF,4DAA4D;AAC5D,MAAM,UAAU,SAAS,CAAC,MAAmB;IAC3C,OAAO,GAAG,UAAU,CAAC,MAAM,CAAC,IAAI,gBAAgB,WAAW,CAAC;AAC9D,CAAC;AAED,MAAM,CAAC,MAAM,cAAc,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2D7B,CAAC;AAEF,mFAAmF;AACnF,MAAM,UAAU,iBAAiB,CAAC,GAAW,EAAE,MAAmB;IAChE,MAAM,GAAG,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;IAC9B,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IACjC,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtD,EAAE,CAAC,aAAa,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;IACvC,OAAO,GAAG,CAAC;AACb,CAAC"}
package/dist/build.js ADDED
@@ -0,0 +1,188 @@
1
+ /**
2
+ * `wayform build <N>` — launch the user's own coding agent, interactively in
3
+ * their terminal, to build plan #N with the wayform-build skill. No headless
4
+ * runs, no shell: prompt and project are untrusted, so argv arrays only.
5
+ */
6
+ import { execFileSync, spawn } from "node:child_process";
7
+ import fs from "node:fs";
8
+ import os from "node:os";
9
+ import path from "node:path";
10
+ import { defaultProject, envVar } from "./config.js";
11
+ import { skillPath } from "./build-skill.js";
12
+ import { parseRemoteClients } from "./init-remote.js";
13
+ const USAGE = "Usage: wayform build <N> [--client claude|cursor|codex] [--project <name>]";
14
+ const ORDER = ["claude", "cursor", "codex"];
15
+ export class BuildError extends Error {
16
+ }
17
+ export function parsePlanNumber(raw) {
18
+ const m = /^#?(\d+)$/.exec(raw ?? "");
19
+ const n = m ? Number(m[1]) : 0;
20
+ if (!Number.isSafeInteger(n) || n < 1)
21
+ throw new BuildError(USAGE);
22
+ return n;
23
+ }
24
+ // Byte-identical with the desktop app's Rust build_prompt.
25
+ export function buildPrompt(client, n, project) {
26
+ // Codex invokes a skill from the prompt with `$name` (verified, codex 0.160).
27
+ if (client === "claude")
28
+ return `/wayform-build #${n} in project "${project}"`;
29
+ if (client === "codex")
30
+ return `$wayform-build #${n} in project "${project}"`;
31
+ return `Use the wayform-build skill to build plan #${n} in project "${project}".`;
32
+ }
33
+ /** The command to run for a client, or undefined if its binary is missing. */
34
+ export function buildCommand(client, repoDir, prompt, deps) {
35
+ if (client === "claude") {
36
+ const local = path.join(deps.home, ".claude", "local", "claude");
37
+ const bin = deps.which("claude")
38
+ ? "claude"
39
+ : deps.exists(local)
40
+ ? local
41
+ : undefined;
42
+ return bin ? { bin, args: [prompt] } : undefined;
43
+ }
44
+ if (client === "cursor") {
45
+ const bin = deps.which("agent")
46
+ ? "agent"
47
+ : deps.which("cursor-agent")
48
+ ? "cursor-agent"
49
+ : undefined;
50
+ return bin ? { bin, args: ["--workspace", repoDir, prompt] } : undefined;
51
+ }
52
+ return deps.which("codex") ? { bin: "codex", args: [prompt] } : undefined;
53
+ }
54
+ export function planBuild(args, deps) {
55
+ const flags = {};
56
+ const pos = [];
57
+ for (let i = 0; i < args.length; i++) {
58
+ const a = args[i];
59
+ if (a === "--client" || a === "--project") {
60
+ const v = args[++i];
61
+ if (!v || v.startsWith("--"))
62
+ throw new BuildError(USAGE);
63
+ flags[a.slice(2)] = v;
64
+ }
65
+ else if (a.startsWith("--")) {
66
+ throw new BuildError(USAGE); // unknown flag or --flag=value form
67
+ }
68
+ else
69
+ pos.push(a);
70
+ }
71
+ if (pos.length > 1)
72
+ throw new BuildError(USAGE);
73
+ const positional = pos[0];
74
+ const flag = (name) => flags[name];
75
+ const n = parsePlanNumber(positional);
76
+ const repoDir = deps.repoDir(deps.cwd);
77
+ const project = flag("project") ?? envVar("PROJECT") ?? defaultProject(repoDir);
78
+ const has = (c) => deps.exists(path.join(repoDir, skillPath(c)));
79
+ const cmd = (c) => buildCommand(c, repoDir, buildPrompt(c, n, project), deps);
80
+ const plan = (c, notice) => {
81
+ const { bin, args: a } = cmd(c);
82
+ return { bin, args: a, cwd: repoDir, client: c, notice };
83
+ };
84
+ const want = flag("client");
85
+ if (want !== undefined) {
86
+ let c;
87
+ try {
88
+ const [id] = parseRemoteClients(want);
89
+ if (id !== "claude" && id !== "cursor" && id !== "codex") {
90
+ throw new BuildError(`wayform build supports claude, cursor and codex (not ${id}).`);
91
+ }
92
+ c = id;
93
+ }
94
+ catch (e) {
95
+ // parseRemoteClients lists every init client; build supports three.
96
+ throw e instanceof BuildError
97
+ ? e
98
+ : new BuildError(`Unknown client "${want}". Use: claude, cursor, codex`);
99
+ }
100
+ if (!has(c)) {
101
+ throw new BuildError(`${skillPath(c)} is missing — run \`wayform init --remote\` first.`);
102
+ }
103
+ if (!cmd(c))
104
+ throw new BuildError(`${c} is not installed (not on PATH).`);
105
+ return plan(c);
106
+ }
107
+ const withSkill = ORDER.filter(has);
108
+ const ready = withSkill.filter((c) => cmd(c));
109
+ if (ready.length === 0) {
110
+ // cursor and codex share one path; list it once.
111
+ const missingSkill = [
112
+ ...new Set(ORDER.filter((c) => !has(c)).map(skillPath)),
113
+ ];
114
+ throw new BuildError(withSkill.length === 0
115
+ ? `No wayform-build skill found (missing: ${missingSkill.join(", ")}) — run \`wayform init --remote\` first.`
116
+ : `Skill installed for ${withSkill.join(", ")} but no matching agent is on PATH. Install one of them.`);
117
+ }
118
+ return plan(ready[0], ready.length > 1
119
+ ? `Using ${ready[0]} (pass --client to choose).`
120
+ : undefined);
121
+ }
122
+ const defaultDeps = () => ({
123
+ which: (bin) => {
124
+ for (const d of (process.env.PATH ?? "").split(path.delimiter)) {
125
+ const f = path.join(d, bin);
126
+ try {
127
+ fs.accessSync(f, fs.constants.X_OK);
128
+ if (fs.statSync(f).isFile())
129
+ return f;
130
+ }
131
+ catch {
132
+ /* keep looking */
133
+ }
134
+ }
135
+ return undefined;
136
+ },
137
+ exists: fs.existsSync,
138
+ spawn: (bin, args, opts) => spawn(bin, args, opts),
139
+ cwd: process.cwd(),
140
+ home: os.homedir(),
141
+ proc: process,
142
+ repoDir: (cwd) => {
143
+ try {
144
+ return execFileSync("git", ["rev-parse", "--show-toplevel"], {
145
+ cwd,
146
+ encoding: "utf8",
147
+ stdio: ["ignore", "pipe", "ignore"],
148
+ }).trim();
149
+ }
150
+ catch {
151
+ return cwd;
152
+ }
153
+ },
154
+ });
155
+ export async function runBuild(args, deps = defaultDeps()) {
156
+ const proc = deps.proc;
157
+ let plan;
158
+ try {
159
+ plan = planBuild(args, deps);
160
+ }
161
+ catch (e) {
162
+ if (!(e instanceof BuildError))
163
+ throw e;
164
+ console.error(e.message);
165
+ return proc.exit(1);
166
+ }
167
+ if (plan.notice)
168
+ console.error(plan.notice);
169
+ const child = deps.spawn(plan.bin, plan.args, {
170
+ cwd: plan.cwd,
171
+ stdio: "inherit",
172
+ });
173
+ // The interactive agent handles Ctrl-C itself (SIGINT hits the whole
174
+ // foreground group); we must outlive it to relay its exit code.
175
+ proc.on("SIGINT", () => { });
176
+ for (const sig of ["SIGTERM", "SIGHUP"]) {
177
+ proc.on(sig, () => child.kill(sig));
178
+ }
179
+ const code = await new Promise((resolve) => {
180
+ child.on("error", (err) => {
181
+ console.error(`Could not launch ${plan.bin}: ${err.message}`);
182
+ resolve(1);
183
+ });
184
+ child.on("exit", (c, sig) => resolve(c ?? (sig ? 128 + (os.constants.signals[sig] ?? 1) : 1)));
185
+ });
186
+ proc.exit(code);
187
+ }
188
+ //# sourceMappingURL=build.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"build.js","sourceRoot":"","sources":["../src/build.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,YAAY,EAAE,KAAK,EAAqB,MAAM,oBAAoB,CAAC;AAC5E,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,SAAS,EAAoB,MAAM,kBAAkB,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEtD,MAAM,KAAK,GACT,4EAA4E,CAAC;AAC/E,MAAM,KAAK,GAAkB,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;AAmC3D,MAAM,OAAO,UAAW,SAAQ,KAAK;CAAG;AAExC,MAAM,UAAU,eAAe,CAAC,GAAuB;IACrD,MAAM,CAAC,GAAG,WAAW,CAAC,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC;IACtC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/B,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;QAAE,MAAM,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC;IACnE,OAAO,CAAC,CAAC;AACX,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,WAAW,CACzB,MAAmB,EACnB,CAAS,EACT,OAAe;IAEf,8EAA8E;IAC9E,IAAI,MAAM,KAAK,QAAQ;QACrB,OAAO,mBAAmB,CAAC,gBAAgB,OAAO,GAAG,CAAC;IACxD,IAAI,MAAM,KAAK,OAAO;QAAE,OAAO,mBAAmB,CAAC,gBAAgB,OAAO,GAAG,CAAC;IAC9E,OAAO,8CAA8C,CAAC,gBAAgB,OAAO,IAAI,CAAC;AACpF,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,YAAY,CAC1B,MAAmB,EACnB,OAAe,EACf,MAAc,EACd,IAAkD;IAElD,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;QACxB,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;QACjE,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC;YAC9B,CAAC,CAAC,QAAQ;YACV,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;gBAClB,CAAC,CAAC,KAAK;gBACP,CAAC,CAAC,SAAS,CAAC;QAChB,OAAO,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IACnD,CAAC;IACD,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;QACxB,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;YAC7B,CAAC,CAAC,OAAO;YACT,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC;gBAC1B,CAAC,CAAC,cAAc;gBAChB,CAAC,CAAC,SAAS,CAAC;QAChB,OAAO,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,aAAa,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IAC3E,CAAC;IACD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;AAC5E,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,IAAc,EAAE,IAAe;IACvD,MAAM,KAAK,GAA2B,EAAE,CAAC;IACzC,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,IAAI,CAAC,KAAK,UAAU,IAAI,CAAC,KAAK,WAAW,EAAE,CAAC;YAC1C,MAAM,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;YACpB,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC;gBAAE,MAAM,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC;YAC1D,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QACxB,CAAC;aAAM,IAAI,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,oCAAoC;QACnE,CAAC;;YAAM,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACrB,CAAC;IACD,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC;QAAE,MAAM,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC;IAChD,MAAM,UAAU,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;IAC1B,MAAM,IAAI,GAAG,CAAC,IAAY,EAAsB,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC/D,MAAM,CAAC,GAAG,eAAe,CAAC,UAAU,CAAC,CAAC;IACtC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACvC,MAAM,OAAO,GACX,IAAI,CAAC,SAAS,CAAC,IAAI,MAAM,CAAC,SAAS,CAAC,IAAI,cAAc,CAAC,OAAO,CAAC,CAAC;IAElE,MAAM,GAAG,GAAG,CAAC,CAAc,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9E,MAAM,GAAG,GAAG,CAAC,CAAc,EAAE,EAAE,CAC7B,YAAY,CAAC,CAAC,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,CAAC;IAC7D,MAAM,IAAI,GAAG,CAAC,CAAc,EAAE,MAAe,EAAa,EAAE;QAC1D,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC,CAAE,CAAC;QACjC,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3D,CAAC,CAAC;IAEF,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC5B,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,IAAI,CAAc,CAAC;QACnB,IAAI,CAAC;YACH,MAAM,CAAC,EAAE,CAAC,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;YACtC,IAAI,EAAE,KAAK,QAAQ,IAAI,EAAE,KAAK,QAAQ,IAAI,EAAE,KAAK,OAAO,EAAE,CAAC;gBACzD,MAAM,IAAI,UAAU,CAClB,wDAAwD,EAAE,IAAI,CAC/D,CAAC;YACJ,CAAC;YACD,CAAC,GAAG,EAAE,CAAC;QACT,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,oEAAoE;YACpE,MAAM,CAAC,YAAY,UAAU;gBAC3B,CAAC,CAAC,CAAC;gBACH,CAAC,CAAC,IAAI,UAAU,CACZ,mBAAmB,IAAI,+BAA+B,CACvD,CAAC;QACR,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YACZ,MAAM,IAAI,UAAU,CAClB,GAAG,SAAS,CAAC,CAAC,CAAC,oDAAoD,CACpE,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;YAAE,MAAM,IAAI,UAAU,CAAC,GAAG,CAAC,kCAAkC,CAAC,CAAC;QAC1E,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC;IACjB,CAAC;IAED,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACpC,MAAM,KAAK,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9C,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,iDAAiD;QACjD,MAAM,YAAY,GAAG;YACnB,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;SACxD,CAAC;QACF,MAAM,IAAI,UAAU,CAClB,SAAS,CAAC,MAAM,KAAK,CAAC;YACpB,CAAC,CAAC,0CAA0C,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,0CAA0C;YAC7G,CAAC,CAAC,uBAAuB,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,yDAAyD,CACzG,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,CACT,KAAK,CAAC,CAAC,CAAC,EACR,KAAK,CAAC,MAAM,GAAG,CAAC;QACd,CAAC,CAAC,SAAS,KAAK,CAAC,CAAC,CAAC,6BAA6B;QAChD,CAAC,CAAC,SAAS,CACd,CAAC;AACJ,CAAC;AAED,MAAM,WAAW,GAAG,GAAc,EAAE,CAAC,CAAC;IACpC,KAAK,EAAE,CAAC,GAAG,EAAE,EAAE;QACb,KAAK,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;YAC/D,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;YAC5B,IAAI,CAAC;gBACH,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;gBACpC,IAAI,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE;oBAAE,OAAO,CAAC,CAAC;YACxC,CAAC;YAAC,MAAM,CAAC;gBACP,kBAAkB;YACpB,CAAC;QACH,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,EAAE,EAAE,CAAC,UAAU;IACrB,KAAK,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC;IAClD,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;IAClB,IAAI,EAAE,EAAE,CAAC,OAAO,EAAE;IAClB,IAAI,EAAE,OAAO;IACb,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;QACf,IAAI,CAAC;YACH,OAAO,YAAY,CAAC,KAAK,EAAE,CAAC,WAAW,EAAE,iBAAiB,CAAC,EAAE;gBAC3D,GAAG;gBACH,QAAQ,EAAE,MAAM;gBAChB,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC;aACpC,CAAC,CAAC,IAAI,EAAE,CAAC;QACZ,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,GAAG,CAAC;QACb,CAAC;IACH,CAAC;CACF,CAAC,CAAC;AAEH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,IAAc,EACd,OAAkB,WAAW,EAAE;IAE/B,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;IACvB,IAAI,IAAe,CAAC;IACpB,IAAI,CAAC;QACH,IAAI,GAAG,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC/B,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,IAAI,CAAC,CAAC,CAAC,YAAY,UAAU,CAAC;YAAE,MAAM,CAAC,CAAC;QACxC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QACzB,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACtB,CAAC;IACD,IAAI,IAAI,CAAC,MAAM;QAAE,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC5C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,EAAE;QAC5C,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,KAAK,EAAE,SAAS;KACjB,CAAC,CAAC;IACH,qEAAqE;IACrE,gEAAgE;IAChE,IAAI,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IAC5B,KAAK,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAU,EAAE,CAAC;QACjD,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACtC,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,IAAI,OAAO,CAAS,CAAC,OAAO,EAAE,EAAE;QACjD,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;YACxB,OAAO,CAAC,KAAK,CAAC,oBAAoB,IAAI,CAAC,GAAG,KAAK,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;YAC9D,OAAO,CAAC,CAAC,CAAC,CAAC;QACb,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,CAC1B,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CACjE,CAAC;IACJ,CAAC,CAAC,CAAC;IACH,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAClB,CAAC"}
package/dist/cli.js CHANGED
@@ -10,22 +10,26 @@
10
10
  * wayform stop-review <client> -> Stop no-op (legacy; re-engagement removed)
11
11
  * wayform login -> GitHub OAuth; tokens go to the OS keychain
12
12
  * wayform init [flags] -> installer (add --remote for hosted members)
13
+ * wayform build <N> [flags] -> launch your agent to build plan #N
13
14
  * wayform doctor -> local diagnostics
14
15
  * wayform space create [flags] -> print App install URL + allowlist reminder
16
+ * wayform hookd [--status] -> local keep-alive pipe for hooks (self-spawned)
15
17
  *
16
18
  * `hook`/`prompt-hook` set WAYFORM_HOOK_CLIENT from the positional arg, then
17
19
  * delegate to the neutral run functions (which self-load .memorylayer-hook.env).
18
20
  */
19
- import { loadHookEnv } from "./config.js";
21
+ import { loadConfig, loadHookEnv } from "./config.js";
20
22
  import { runServer } from "./index.js";
21
23
  import { runHook } from "./hook.js";
22
24
  import { runPromptHook } from "./prompt-hook.js";
23
25
  import { runGuardHook } from "./guard-hook.js";
24
26
  import { runInit } from "./init.js";
27
+ import { runBuild } from "./build.js";
25
28
  import { runDoctor } from "./doctor.js";
26
29
  import { runSpaceCreate } from "./space-create.js";
27
30
  import { runLogin } from "./oauth-login.js";
28
31
  import { runToken } from "./token.js";
32
+ import { daemonRunning, socketPath, startDaemon } from "./hook-daemon.js";
29
33
  async function main() {
30
34
  // Self-load .memorylayer-hook.env from the project cwd for every subcommand,
31
35
  // so the command is self-contained (no bash launcher). loadConfig stays pure.
@@ -55,6 +59,9 @@ async function main() {
55
59
  case "init":
56
60
  await runInit(rest);
57
61
  return;
62
+ case "build":
63
+ await runBuild(rest);
64
+ return;
58
65
  case "doctor":
59
66
  await runDoctor();
60
67
  return;
@@ -64,6 +71,20 @@ async function main() {
64
71
  case "token":
65
72
  await runToken(rest);
66
73
  return;
74
+ case "hookd": {
75
+ if (rest[0] === "--status") {
76
+ const up = await daemonRunning();
77
+ console.log(`hookd ${up ? "running" : "not running"}: ${socketPath()}`);
78
+ if (!up)
79
+ process.exitCode = 1;
80
+ return;
81
+ }
82
+ const { gatewayUrl } = loadConfig();
83
+ if (!gatewayUrl)
84
+ throw new Error("hookd needs WAYFORM_GATEWAY_URL");
85
+ await startDaemon({ gatewayUrl, socketPath: socketPath() });
86
+ return;
87
+ }
67
88
  case "space":
68
89
  if (rest[0] === "create") {
69
90
  await runSpaceCreate(rest.slice(1));
@@ -76,7 +97,7 @@ async function main() {
76
97
  await runServer();
77
98
  return;
78
99
  default:
79
- console.error(`Unknown command "${sub}". Use: wayform [hook|prompt-hook|guard|stop-review|init|doctor|login|token|space] …`);
100
+ console.error(`Unknown command "${sub}". Use: wayform [hook|prompt-hook|guard|stop-review|init|build|doctor|login|token|hookd|space] …`);
80
101
  process.exit(1);
81
102
  }
82
103
  }
package/dist/cli.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}
@@ -1 +1 @@
1
- {"version":3,"file":"frontmatter.js","sourceRoot":"","sources":["../src/frontmatter.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"frontmatter.js","sourceRoot":"","sources":["../src/frontmatter.ts"],"names":[],"mappings":"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"}
@@ -2,27 +2,36 @@
2
2
  /**
3
3
  * PreToolUse guard hook — the enforcement half of wayform.
4
4
  *
5
- * Claude Code runs this before every tool call. For mutating tools only, it
5
+ * Claude Code, Cursor and Codex run this before mutating tool calls. It
6
6
  * summarizes the proposed action, asks the gateway whether it contradicts a
7
- * live team decision, and emits an "ask" permission decision when it does.
7
+ * live team decision, and when it does emits Claude Code's native "ask" — or,
8
+ * on Cursor/Codex (which cannot ask), a deny carrying a per-decision ticket the
9
+ * model redeems via guard_allow after the user confirms.
8
10
  *
9
11
  * FAIL-OPEN, and more load-bearing here than anywhere else: this sits on the
10
12
  * hot path of every edit. Wrong config, offline gateway, slow judge, weird
11
- * payload — all resolve to the empty no-op and exit 0, so the tool runs exactly
12
- * as if no hook existed. This hook NEVER emits "deny" (spec decision 1).
13
+ * payload — all resolve to the client's allow output and exit 0, so the tool
14
+ * runs exactly as if no hook existed.
13
15
  */
14
16
  import { loadConfig, defaultProject, envVar } from "./config.js";
15
17
  import { remoteGuardCheck } from "./remote-read.js";
16
- import { resolveClient, renderGuardDecision, renderEmpty, } from "./hook-clients.js";
18
+ import { resolveClient, renderGuardDecision, renderGuardAllow, } from "./hook-clients.js";
17
19
  import { isMain } from "./is-main.js";
18
20
  /**
19
21
  * PreToolUse fires on EVERY tool. Guarding reads would put network latency on
20
22
  * calls that cannot contradict a decision, so only mutating tools qualify.
21
23
  */
22
24
  export const GUARDED_TOOLS = new Set([
25
+ // Claude Code (Bash is shared with Codex)
23
26
  "Edit",
24
27
  "Write",
25
28
  "Bash",
29
+ // Codex
30
+ "apply_patch",
31
+ // Cursor
32
+ "Shell",
33
+ "StrReplace",
34
+ "Delete",
26
35
  ]);
27
36
  /** On unless explicitly disabled; "ask" is already the safe setting. */
28
37
  export function guardEnabled(env) {
@@ -39,17 +48,42 @@ export function summarizeAction(toolName, toolInput) {
39
48
  return "";
40
49
  const input = toolInput;
41
50
  const str = (k) => typeof input[k] === "string" ? input[k] : "";
42
- const path = str("file_path");
43
- const payload = str("command") || str("new_string") || str("content") || str("prompt");
44
- if (!path && !payload)
45
- return "";
51
+ const path = str("file_path") || str("path");
52
+ const keys = ["command", "new_string", "content", "contents", "prompt"];
53
+ const payload = keys.map(str).find(Boolean) ?? "";
46
54
  const head = path ? `${toolName} ${path}` : toolName;
47
- return `${head}: ${payload}`.slice(0, ACTION_CHARS);
55
+ // A known key present but empty (an Edit that deletes text) keeps the plain
56
+ // summary; only an input with none of them falls back to JSON.
57
+ if (keys.some((k) => typeof input[k] === "string")) {
58
+ if (!path && !payload)
59
+ return "";
60
+ return `${head}: ${payload}`.slice(0, ACTION_CHARS);
61
+ }
62
+ if (path) {
63
+ // A path-only Delete is a whole action; anything else with unknown fields
64
+ // (e.g. Cursor's undocumented Write content key) still gets judged.
65
+ const rest = { ...input };
66
+ delete rest.file_path;
67
+ delete rest.path;
68
+ if (Object.keys(rest).length === 0)
69
+ return head.slice(0, ACTION_CHARS);
70
+ }
71
+ const json = JSON.stringify(input);
72
+ return json === "{}" ? "" : `${head}: ${json}`.slice(0, ACTION_CHARS);
73
+ }
74
+ /** Claude Code sets agent_id only inside a subagent; absent = main agent. */
75
+ export function agentLabel(p) {
76
+ if (typeof p.agent_type === "string" && p.agent_type)
77
+ return p.agent_type;
78
+ if (typeof p.agent_id === "string" && p.agent_id)
79
+ return "subagent";
80
+ return undefined;
48
81
  }
49
82
  export async function runGuardHook() {
50
83
  const client = resolveClient(envVar("HOOK_CLIENT"));
84
+ // Cursor blocks on `{}`, so every fail-open exit goes through here.
51
85
  const emitEmpty = () => {
52
- process.stdout.write(renderEmpty(client));
86
+ process.stdout.write(renderGuardAllow(client));
53
87
  process.exit(0);
54
88
  };
55
89
  try {
@@ -78,10 +112,15 @@ export async function runGuardHook() {
78
112
  const cfg = loadConfig();
79
113
  // null = gateway unusable. There is no local fallback by design: judging
80
114
  // needs the index and the model, both of which live in the gateway.
81
- const check = await remoteGuardCheck(cfg, project, action);
115
+ const check = await remoteGuardCheck(cfg, project, action, {
116
+ agent: agentLabel(payload),
117
+ });
82
118
  if (check == null || check.decision !== "ask")
83
119
  emitEmpty();
84
- process.stdout.write(renderGuardDecision(client, "ask", check.reason));
120
+ process.stdout.write(renderGuardDecision(client, "ask", check.reason, {
121
+ project,
122
+ ticket: check.ticket,
123
+ }));
85
124
  process.exit(0);
86
125
  }
87
126
  catch {
@@ -1 +1 @@
1
- {"version":3,"file":"guard-hook.js","sourceRoot":"","sources":["../src/guard-hook.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"guard-hook.js","sourceRoot":"","sources":["../src/guard-hook.ts"],"names":[],"mappings":"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"}
@@ -56,24 +56,68 @@ export function renderPromptContext(client, text) {
56
56
  });
57
57
  }
58
58
  /**
59
- * PreToolUse envelope (Claude Code) — the one place wayform can stop an action
60
- * before it happens. Only Claude Code exposes a blocking pre-execution hook we
61
- * have verified, exactly as only Claude Code supports UserPromptSubmit
62
- * injection; other clients get the empty no-op until their contract is checked.
63
- *
64
- * "deny" is never emitted in this phase (spec decision 1): a false positive on
65
- * ask costs one keystroke, on deny it costs the feature.
59
+ * The guard's fail-open output. Cursor treats any permission-hook output that
60
+ * doesn't match its schema as a BLOCK, so `{}` would stop every guarded call;
61
+ * its allow must be explicit. Everyone else gets the usual empty no-op.
66
62
  */
67
- export function renderGuardDecision(client, decision, reason) {
68
- if (client !== "claude-code" || decision === "allow") {
69
- return renderEmpty(client);
63
+ export function renderGuardAllow(client) {
64
+ return client === "cursor"
65
+ ? JSON.stringify({ permission: "allow" })
66
+ : renderEmpty(client);
67
+ }
68
+ /** The block text the model reads on clients that can only deny. */
69
+ export function guardBlockMessage(reason, project, ticket, client) {
70
+ // Codex appends ". Command: …" itself, so its copy drops the final period.
71
+ const end = client === "codex" ? "" : ".";
72
+ return (`Wayform blocked this action: it contradicts a recorded team decision.\n\n${reason}\n\n` +
73
+ `Do not retry it or work around it. Ask the user whether to go ahead anyway ` +
74
+ `(if you are a subagent, stop and report this block, with the ticket, to your orchestrator). ` +
75
+ `Only if the user explicitly confirms: call the Wayform MCP tool ` +
76
+ `guard_allow(project="${project}", ticket="${ticket}"), then retry. The override covers this decision for 10 minutes; a different conflict will ask again${end}`);
77
+ }
78
+ /**
79
+ * PreToolUse envelope — the one place wayform can stop an action before it
80
+ * happens. Claude Code gets a native "ask". Cursor and Codex cannot ask:
81
+ * Codex parses "ask" but does not support it, and Cursor documents '"ask" is
82
+ * accepted by the schema but not enforced for preToolUse today'
83
+ * (cursor.com/docs/agent/hooks). Both CAN deny with a message the model sees,
84
+ * so they deny with a per-decision ticket the model hands to guard_allow once the
85
+ * user confirms — the ask, routed through the model. Without a ticket (older
86
+ * gateway) a deny would be a dead end, so they allow.
87
+ */
88
+ export function renderGuardDecision(client, decision, reason, opts = {}) {
89
+ if (decision === "allow")
90
+ return renderGuardAllow(client);
91
+ switch (client) {
92
+ case "claude-code":
93
+ return JSON.stringify({
94
+ hookSpecificOutput: {
95
+ hookEventName: "PreToolUse",
96
+ permissionDecision: "ask",
97
+ permissionDecisionReason: `Wayform — this contradicts a recorded team decision:\n\n${reason}`,
98
+ },
99
+ });
100
+ case "raw":
101
+ return renderEmpty(client);
102
+ case "cursor":
103
+ case "codex": {
104
+ if (!opts.ticket)
105
+ return renderGuardAllow(client);
106
+ const msg = guardBlockMessage(reason, opts.project ?? "", opts.ticket, client);
107
+ return client === "cursor"
108
+ ? JSON.stringify({
109
+ permission: "deny",
110
+ user_message: msg,
111
+ agent_message: msg,
112
+ })
113
+ : JSON.stringify({
114
+ hookSpecificOutput: {
115
+ hookEventName: "PreToolUse",
116
+ permissionDecision: "deny",
117
+ permissionDecisionReason: msg,
118
+ },
119
+ });
120
+ }
70
121
  }
71
- return JSON.stringify({
72
- hookSpecificOutput: {
73
- hookEventName: "PreToolUse",
74
- permissionDecision: "ask",
75
- permissionDecisionReason: `Wayform — this contradicts a recorded team decision:\n\n${reason}`,
76
- },
77
- });
78
122
  }
79
123
  //# sourceMappingURL=hook-clients.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"hook-clients.js","sourceRoot":"","sources":["../src/hook-clients.ts"],"names":[],"mappings":"AAUA,8EAA8E;AAC9E,MAAM,UAAU,aAAa,CAAC,GAAuB;IACnD,QAAQ,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC;QACzC,KAAK,aAAa,CAAC;QACnB,KAAK,aAAa,CAAC;QACnB,KAAK,YAAY;YACf,OAAO,aAAa,CAAC;QACvB,KAAK,KAAK;YACR,OAAO,KAAK,CAAC;QACf,KAAK,OAAO;YACV,OAAO,OAAO,CAAC;QACjB;YACE,OAAO,QAAQ,CAAC;IACpB,CAAC;AACH,CAAC;AAED,wDAAwD;AACxD,MAAM,UAAU,aAAa,CAAC,MAAkB,EAAE,IAAY;IAC5D,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,KAAK;YACR,iEAAiE;YACjE,OAAO,IAAI,CAAC;QACd,KAAK,aAAa,CAAC;QACnB,KAAK,OAAO;YACV,uEAAuE;YACvE,oEAAoE;YACpE,OAAO,IAAI,CAAC,SAAS,CAAC;gBACpB,kBAAkB,EAAE;oBAClB,aAAa,EAAE,cAAc;oBAC7B,iBAAiB,EAAE,IAAI;iBACxB;aACF,CAAC,CAAC;QACL,KAAK,QAAQ;YACX,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,kBAAkB,EAAE,IAAI,EAAE,CAAC,CAAC;IACxD,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,MAAkB;IAC5C,OAAO,MAAM,KAAK,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AACtC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAkB,EAAE,IAAY;IAClE,IAAI,MAAM,KAAK,aAAa;QAAE,OAAO,WAAW,CAAC,MAAM,CAAC,CAAC;IACzD,OAAO,IAAI,CAAC,SAAS,CAAC;QACpB,kBAAkB,EAAE;YAClB,aAAa,EAAE,kBAAkB;YACjC,iBAAiB,EAAE,IAAI;SACxB;KACF,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,mBAAmB,CACjC,MAAkB,EAClB,QAAyB,EACzB,MAAc;IAEd,IAAI,MAAM,KAAK,aAAa,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;QACrD,OAAO,WAAW,CAAC,MAAM,CAAC,CAAC;IAC7B,CAAC;IACD,OAAO,IAAI,CAAC,SAAS,CAAC;QACpB,kBAAkB,EAAE;YAClB,aAAa,EAAE,YAAY;YAC3B,kBAAkB,EAAE,KAAK;YACzB,wBAAwB,EAAE,2DAA2D,MAAM,EAAE;SAC9F;KACF,CAAC,CAAC;AACL,CAAC"}
1
+ {"version":3,"file":"hook-clients.js","sourceRoot":"","sources":["../src/hook-clients.ts"],"names":[],"mappings":"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"}