Mola-maker/mstack / skills/m-goal
m-goal
VerifiedLong-running goal loop: goal file, checkpoints, stop rules, mandatory closeout. Use for run-until-done work, 别停/一直做到完成.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 9.6 KB |
| references/closeout.md | markdown | 2.2 KB |
| references/goal-file-format.md | markdown | 4.3 KB |
| scripts/goal-preflight.test.mjs | script | 4.0 KB |
| scripts/goal-state.mjs | script | 7.8 KB |
| scripts/goal-state.test.mjs | script | 8.8 KB |
scripts/goal-state.test.mjs
View on GitHub// Tests for goal-state.mjs. Run: node --test "skills/m-goal/scripts/*.test.mjs"
import { test } from "node:test";
import { execFileSync } from "node:child_process";
import { mkdtempSync, readFileSync, writeFileSync } from "node:fs";
import { tmpdir } from "node:os";
import { join } from "node:path";
const script = new URL("./goal-state.mjs", import.meta.url).pathname.replace(/^\/([A-Za-z]:)/, "$1");
const run = (args, opts = {}) => {
try {
return { out: execFileSync(process.execPath, [script, ...args], { encoding: "utf8", ...opts }).trim(), code: 0 };
} catch (e) {
return { out: String(e.stdout ?? "").trim(), err: String(e.stderr ?? "").trim(), code: e.status };
}
};
const state = (dir) => JSON.parse(readFileSync(join(dir, "demo.state.json"), "utf8"));
test("record creates state file and reports ok", () => {
const dir = mkdtempSync(join(tmpdir(), "goal-state-"));
const r = run(["record", dir, "demo", "--round", "--progress", "--tokens", "1200", "--budget", "40"]);
if (r.code !== 0) throw new Error(`exit ${r.code}: ${r.err}`);
if (!r.out.startsWith("ok ")) throw new Error(`unexpected verdict: ${r.out}`);
const s = state(dir);
if (s.rounds !== 1 || s.tokensUsed !== 1200 || s.budgetPct !== 40 || !s.lastProgressAt) throw new Error(`bad state: ${r.out}`);
if (s.status !== "active") throw new Error(`expected default status active, got ${s.status}`);
});
test("init records the start commit and refuses to re-init an active goal", () => {
const dir = mkdtempSync(join(tmpdir(), "goal-state-"));
const r = run(["init", dir, "demo", "--start-commit", "abc1234"]);
if (r.code !== 0) throw new Error(`exit ${r.code}: ${r.err}`);
const s = state(dir);
if (s.startCommit !== "abc1234" || s.status !== "active" || s.rounds !== 0) throw new Error(`bad init state: ${JSON.stringify(s)}`);
const again = run(["init", dir, "demo", "--start-commit", "def5678"]);
if (again.code !== 2) throw new Error(`expected exit 2 on re-init, got ${again.code}: ${again.out}`);
if (state(dir).startCommit !== "abc1234") throw new Error("re-init overwrote the start commit");
});
test("same signature 3 times -> stop with exit 1", () => {
const dir = mkdtempSync(join(tmpdir(), "goal-state-"));
run(["record", dir, "demo", "--fail", "E_TIMEOUT x"]);
run(["record", dir, "demo", "--fail", "E_TIMEOUT x"]);
const third = run(["record", dir, "demo", "--fail", "E_TIMEOUT x"]);
if (third.code !== 1 || !third.out.startsWith("stop")) throw new Error(`expected stop/1, got ${third.code}: ${third.out}`);
if (!third.out.includes("in a row")) throw new Error(`expected "in a row" wording: ${third.out}`);
});
test("failures are consecutive: --progress resets every counter (bug regression)", () => {
const dir = mkdtempSync(join(tmpdir(), "goal-state-"));
run(["record", dir, "demo", "--fail", "E_TIMEOUT x"]);
run(["record", dir, "demo", "--fail", "E_TIMEOUT x"]);
const recovered = run(["record", dir, "demo", "--fail", "E_TIMEOUT x", "--progress"]);
if (recovered.code !== 0 || !recovered.out.startsWith("ok")) throw new Error(`expected ok after progress, got ${recovered.code}: ${recovered.out}`);
if (Object.keys(state(dir).failures).length !== 0) throw new Error("progress did not reset failure counters");
// Two fresh failures afterwards must still be ok, not carry the old run.
run(["record", dir, "demo", "--fail", "E_TIMEOUT x"]);
const second = run(["record", dir, "demo", "--fail", "E_TIMEOUT x"]);
if (second.code !== 0 || !second.out.startsWith("ok")) throw new Error(`expected ok on 2nd consecutive failure, got ${second.code}: ${second.out}`);
const third = run(["record", dir, "demo", "--fail", "E_TIMEOUT x"]);
if (third.code !== 1 || !third.out.startsWith("stop")) throw new Error(`expected stop on 3rd, got ${third.code}: ${third.out}`);
});
test("budget 90 warns, 100 stops", () => {
const dir = mkdtempSync(join(tmpdir(), "goal-state-"));
const warn = run(["record", dir, "demo", "--budget", "92"]);
if (warn.code !== 0 || !warn.out.startsWith("warn")) throw new Error(`expected warn: ${warn.out}`);
const stop = run(["record", dir, "demo", "--budget", "100"]);
if (stop.code !== 1 || !stop.out.startsWith("stop")) throw new Error(`expected stop: ${stop.out}`);
});
test("record --status sets the status; status prints it without mutating", () => {
const dir = mkdtempSync(join(tmpdir(), "goal-state-"));
run(["init", dir, "demo", "--start-commit", "abc1234", "--min-rounds", "1"]);
run(["record", dir, "demo", "--round"]);
const done = run(["record", dir, "demo", "--status", "done"]);
if (done.code !== 0 || !done.out.includes("status=done")) throw new Error(`expected status=done: ${done.out}`);
if (state(dir).status !== "done") throw new Error("status flag not persisted");
const before = readFileSync(join(dir, "demo.state.json"), "utf8");
const s = run(["status", dir, "demo"]);
if (s.code !== 0 || !s.out.includes("status=done")) throw new Error(`status cmd: ${s.out} ${s.err}`);
if (readFileSync(join(dir, "demo.state.json"), "utf8") !== before) throw new Error("status mutated the file");
});
test("corrupt or malformed state file exits 2 and is never reset (bug regression)", () => {
for (const body of ["not json", '{"rounds":"many"}', '{"failures":{"sig":"nope"}}', "[]", "null"]) {
const dir = mkdtempSync(join(tmpdir(), "goal-state-"));
writeFileSync(join(dir, "demo.state.json"), body);
const rec = run(["record", dir, "demo", "--progress"]);
if (rec.code !== 2) throw new Error(`expected exit 2 for ${body}, got ${rec.code}: ${rec.out}`);
if (readFileSync(join(dir, "demo.state.json"), "utf8") !== body) throw new Error(`corrupt file ${body} was overwritten`);
const st = run(["status", dir, "demo"]);
if (st.code !== 2) throw new Error(`status expected exit 2 for ${body}, got ${st.code}: ${st.out}`);
}
});
test("unknown flag or bad --status exits 2", () => {
const dir = mkdtempSync(join(tmpdir(), "goal-state-"));
if (run(["record", dir, "demo", "--wat"]).code !== 2) throw new Error("expected 2 for unknown flag");
if (run(["record", dir, "demo", "--status", "paused"]).code !== 2) throw new Error("expected 2 for bad status");
if (run(["record"]).code !== 2) throw new Error("expected 2 for missing args");
if (run(["init", dir, "demo"]).code !== 2) throw new Error("init without --start-commit must exit 2");
});
test("rounds go up only with --round; failures, tokens and progress notes do not count (bug regression)", () => {
const dir = mkdtempSync(join(tmpdir(), "goal-state-"));
run(["record", dir, "demo", "--fail", "E_X"]);
run(["record", dir, "demo", "--tokens", "10"]);
run(["record", dir, "demo", "--progress"]);
if (state(dir).rounds !== 0) throw new Error(`plain records raised rounds to ${state(dir).rounds}`);
const r = run(["record", dir, "demo", "--round"]);
if (state(dir).rounds !== 1 || !r.out.includes("rounds=1")) throw new Error(`expected rounds=1: ${r.out}`);
});
test("--status done is rejected below min rounds, accepted at min (bug regression)", () => {
const dir = mkdtempSync(join(tmpdir(), "goal-state-"));
run(["init", dir, "demo", "--start-commit", "abc1234"]);
if (state(dir).minRounds !== 3) throw new Error("default minRounds should be 3");
// Two no-op checkpoints without --round must not satisfy the minimum.
run(["record", dir, "demo"]);
run(["record", dir, "demo"]);
const early = run(["record", dir, "demo", "--status", "done"]);
if (early.code !== 1 || !early.out.includes("rejected")) throw new Error(`expected rejection at 0 rounds, got ${early.code}: ${early.out}`);
if (state(dir).status !== "active") throw new Error("status changed despite rejection");
run(["record", dir, "demo", "--round"]);
run(["record", dir, "demo", "--round"]);
const two = run(["record", dir, "demo", "--status", "done"]);
if (two.code !== 1 || state(dir).status !== "active") throw new Error(`2 rounds < 3 must reject: ${two.out}`);
// The boundary and the status may arrive in one call.
const ok = run(["record", dir, "demo", "--round", "--status", "done"]);
if (ok.code !== 0 || state(dir).status !== "done") throw new Error(`expected done at 3 rounds: ${ok.code} ${ok.out}`);
});
test("--status failed is allowed below min rounds; --min-rounds validates", () => {
const dir = mkdtempSync(join(tmpdir(), "goal-state-"));
run(["init", dir, "demo", "--start-commit", "abc1234", "--min-rounds", "5"]);
if (state(dir).minRounds !== 5) throw new Error("min rounds not stored");
const f = run(["record", dir, "demo", "--status", "failed"]);
if (f.code !== 0 || state(dir).status !== "failed") throw new Error(`failed should be allowed: ${f.out}`);
for (const bad of ["0", "x", "-1"]) {
const d2 = mkdtempSync(join(tmpdir(), "goal-state-"));
if (run(["init", d2, "demo", "--start-commit", "a", "--min-rounds", bad]).code !== 2) throw new Error(`--min-rounds ${bad} must exit 2`);
}
});
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |