npm - @vicfei/dsh-super-agent - Versions diffs - 0.0.0-stage → 0.5.1 - Mend

@vicfei/dsh-super-agent 0.0.0-stage → 0.5.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.

Files changed (56) hide show

package/dist/panel.d.ts ADDED Viewed

@@ -0,0 +1,8 @@
+import { type Server } from "node:http";
+import type { Engine } from "./engine.js";
+export interface PanelState {
+    policy: ReturnType<Engine["policy"]>;
+    tickets: ReturnType<Engine["tickets"]>;
+    decisions: ReturnType<Engine["decisions"]>;
+}
+export declare function startPanel(engine: Engine, port: number, host?: string): Promise<Server>;

package/dist/panel.html ADDED Viewed

@@ -0,0 +1,128 @@
+<!doctype html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>dsh-super-agent</title>
+<style>
+  :root { color-scheme: dark; }
+  * { box-sizing: border-box; }
+  body { margin: 0; font: 14px/1.5 ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;
+         background: #0d1117; color: #c9d1d9; padding: 24px; }
+  h1 { font-size: 16px; margin: 0 0 4px; color: #e6edf3; }
+  .sub { color: #8b949e; margin-bottom: 20px; }
+  h2 { font-size: 13px; color: #8b949e; text-transform: uppercase; letter-spacing: .08em;
+       margin: 24px 0 8px; }
+  .card { background: #161b22; border: 1px solid #30363d; border-radius: 6px; padding: 10px 12px;
+          margin-bottom: 8px; }
+  .quiet { color: #8b949e; }
+  .badge { display: inline-block; border-radius: 10px; padding: 1px 8px; font-size: 12px; margin-right: 6px; }
+  .b-ignore { background: #da363033; color: #f85149; }
+  .b-shadow { background: #d2992233; color: #e3b341; }
+  .b-accept { background: #23863633; color: #3fb950; }
+  .b-person { background: #a371f733; color: #bc8cff; }
+  .mode button { background: #21262d; color: #c9d1d9; border: 1px solid #30363d; border-radius: 6px;
+                 padding: 4px 10px; font: inherit; cursor: pointer; margin-right: 4px; }
+  .mode button.on { border-color: #3fb950; color: #3fb950; }
+  button.stop { background: transparent; color: #f85149; border: 1px solid #f8514966;
+                border-radius: 6px; padding: 1px 8px; font: inherit; cursor: pointer; float: right; }
+  table { border-collapse: collapse; width: 100%; font-size: 13px; }
+  td, th { text-align: left; padding: 4px 10px 4px 0; border-bottom: 1px solid #21262d; vertical-align: top; }
+  th { color: #8b949e; font-weight: normal; }
+  .ex { color: #8b949e; max-width: 420px; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+  footer { margin-top: 28px; color: #6e7681; font-size: 12px; }
+</style>
+</head>
+<body>
+<h1>dsh-super-agent</h1>
+<div class="sub">Messages cannot change permissions — host-enforced admission · policy v<span id=pv></span></div>
+<div class="mode">
+  accept mode:
+  <span id="modes">
+    <button data-mode="off">off</button>
+    <button data-mode="observe">observe</button>
+    <button data-mode="auto">auto</button>
+  </span>
+  <span class="quiet" id="modehint"></span>
+</div>
+<h2>Awaiting a human</h2>
+<div id="awaiting"></div>
+<h2>Observe records — would accept</h2>
+<div id="shadows"></div>
+<h2>Recent decisions</h2>
+<table><thead><tr><th>when</th><th>outcome</th><th>strength</th><th>author</th><th>thread</th><th>basis / excerpt</th></tr></thead>
+<tbody id="decisions"></tbody></table>
+<footer>healthy state takes no space — empty sections mean nothing needs you</footer>
+<script>
+const fmt = t => new Date(t).toISOString().replace('T',' ').slice(5,19);
+const esc = s => String(s ?? '').replace(/[&<>"]/g, c => ({'&':'&amp;','<':'&lt;','>':'&gt;','"':'&quot;'}[c]));
+const threadShort = t => t.replace(/^github:[^\/]+\//, '');
+async function api(path, body) {
+  const res = await fetch(path, body ? {method:'POST', headers:{'content-type':'application/json'}, body: JSON.stringify(body)} : undefined);
+  return res.json();
+}
+async function render() {
+  const s = await api('/api/state');
+  document.getElementById('pv').textContent = s.policy ? s.policy.version : '?';
+  document.querySelectorAll('#modes button').forEach(b => {
+    b.classList.toggle('on', s.policy && b.dataset.mode === s.policy.acceptMode);
+  });
+  document.getElementById('modehint').textContent =
+    s.policy && s.policy.acceptMode === 'auto' ? '' : ' — inferred candidates do not run in this mode';
+  const personTickets = s.tickets.filter(t => t.stage === 'needs-person');
+  const revoked = s.tickets.filter(t => t.revokedReason);
+  document.getElementById('awaiting').innerHTML =
+    (personTickets.length === 0 && revoked.length === 0)
+      ? '<div class="quiet">nothing needs you</div>'
+      : personTickets.map(t => `<div class="card"><span class="badge b-person">needs-person</span>
+          ticket #${t.id} ${esc(t.strength)} ${esc(threadShort(t.threadId))} opener=${esc(t.opener)}
+          <button class="stop" onclick="stopTicket(${t.id})">stop</button></div>`).join('')
+        + revoked.map(t => `<div class="card"><span class="badge b-ignore">revoked</span>
+          ticket #${t.id} — ${esc(t.revokedReason)}</div>`).join('');
+  const shadows = s.decisions.filter(d => d.wouldAccept);
+  document.getElementById('shadows').innerHTML = shadows.length === 0
+    ? '<div class="quiet">no shadow records</div>'
+    : shadows.map(d => `<div class="card"><span class="badge b-shadow">would accept</span>
+        ${fmt(d.ts)} ${esc(d.author)} → ${esc(threadShort(d.threadId))}
+        <div class="quiet">${esc(d.basis)}</div>
+        <div class="ex">${esc(d.excerpt)}</div></div>`).join('');
+  document.getElementById('decisions').innerHTML = s.decisions.map(d => {
+    const cls = d.kind === 'accept' ? 'b-accept' : d.wouldAccept ? 'b-shadow' : 'b-ignore';
+    return `<tr><td class="quiet">${fmt(d.ts)}</td>
+      <td><span class="badge ${cls}">${d.kind}${d.wouldAccept ? ' (would)' : ''}</span></td>
+      <td>${esc(d.strength || '—')}</td><td>${esc(d.author)}${d.isBot ? ' 🤖' : ''}</td>
+      <td class="quiet">${esc(threadShort(d.threadId))}</td>
+      <td>${esc(d.basis)}<div class="ex">${esc(d.excerpt)}</div></td></tr>`;
+  }).join('');
+}
+async function setMode(mode) {
+  if (mode === 'auto' && !confirm('auto accepts inferred work after assessment, without further review.\n\nStart in observe and review records first (docs/002). Switch to auto?')) return;
+  if (mode === 'off' && !confirm('off rejects all inferred candidates. Explicit requests still work. Switch?')) return;
+  await api('/api/mode', { mode });
+  render();
+}
+async function stopTicket(id) {
+  if (!confirm('End ticket #' + id + '? (a person\u2019s stop withdraws its mandate)')) return;
+  await api('/api/stop', { id });
+  render();
+}
+document.getElementById('modes').addEventListener('click', e => {
+  if (e.target.dataset.mode) setMode(e.target.dataset.mode);
+});
+render();
+setInterval(render, 3000);
+</script>
+</body>
+</html>

package/dist/panel.js ADDED Viewed

@@ -0,0 +1,54 @@
+// Panel — one page listing only what awaits a human (docs/000: "A healthy state takes no space";
+// docs/005: minimal panel). Zero runtime deps: node:http + inline HTML. Bind localhost.
+import { createServer } from "node:http";
+import { readFileSync } from "node:fs";
+const PAGE = readFileSync(new URL("./panel.html", import.meta.url), "utf8");
+export function startPanel(engine, port, host = "127.0.0.1") {
+    const server = createServer((req, res) => {
+        const url = new URL(req.url ?? "/", "http://local");
+        const send = (status, type, body) => {
+            res.writeHead(status, { "content-type": type, "cache-control": "no-store" });
+            res.end(body);
+        };
+        if (req.method === "GET" && url.pathname === "/") {
+            send(200, "text/html; charset=utf-8", PAGE);
+            return;
+        }
+        if (req.method === "GET" && url.pathname === "/api/state") {
+            const state = {
+                policy: engine.policy(),
+                tickets: engine.tickets(),
+                decisions: engine.decisions(50),
+            };
+            send(200, "application/json", JSON.stringify(state));
+            return;
+        }
+        if (req.method === "POST" && (url.pathname === "/api/mode" || url.pathname === "/api/stop")) {
+            let body = "";
+            req.on("data", (c) => (body += c));
+            req.on("end", () => {
+                try {
+                    const parsed = JSON.parse(body || "{}");
+                    if (url.pathname === "/api/mode") {
+                        if (parsed.mode !== "off" && parsed.mode !== "observe" && parsed.mode !== "auto") {
+                            send(400, "application/json", JSON.stringify({ error: "mode must be off|observe|auto" }));
+                            return;
+                        }
+                        const next = engine.setAcceptMode(parsed.mode);
+                        send(200, "application/json", JSON.stringify({ policy: next }));
+                        return;
+                    }
+                    const ok = typeof parsed.id === "number" ? engine.stopTicket(parsed.id, "panel") : false;
+                    send(ok ? 200 : 404, "application/json", JSON.stringify({ stopped: ok }));
+                }
+                catch (e) {
+                    send(400, "application/json", JSON.stringify({ error: e instanceof Error ? e.message : String(e) }));
+                }
+            });
+            return;
+        }
+        send(404, "text/plain", "not found");
+    });
+    return new Promise((resolve) => server.listen(port, host, () => resolve(server)));
+}
+//# sourceMappingURL=panel.js.map

package/dist/panel.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"panel.js","sourceRoot":"","sources":["../src/panel.ts"],"names":[],"mappings":"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"}

package/dist/runner.d.ts ADDED Viewed

@@ -0,0 +1,9 @@
+import type { Policy, Trigger } from "./domain.js";
+import { type Assessment, type GateResult, type Resolution } from "./gate.js";
+export interface PollOutcome {
+    trigger: Trigger;
+    gate: GateResult;
+    resolution: Resolution;
+}
+export declare function classify(trigger: Trigger, policy: Policy, assessment: Assessment): PollOutcome;
+export declare function formatOutcome(o: PollOutcome): string;

package/dist/runner.js ADDED Viewed

@@ -0,0 +1,23 @@
+// Runner — poll → gate → resolution. Assessment is a placeholder flag until milestone 3 wires the
+// real OpenAI-compatible layer; observe mode still shadows instead of accepting, so nothing runs.
+import { evaluateGate, resolveCandidate } from "./gate.js";
+export function classify(trigger, policy, assessment) {
+    const gate = evaluateGate(policy, trigger);
+    const resolution = resolveCandidate(policy, gate, assessment);
+    return { trigger, gate, resolution };
+}
+const LABEL = { accept: "ACCEPT", shadow: "WOULD-ACCEPT", reject: "IGNORE" };
+export function formatOutcome(o) {
+    const who = `${o.trigger.author.login}${o.trigger.author.isBot ? "(bot)" : ""}`;
+    const strength = o.gate.strength ? o.gate.strength.toUpperCase() : "NOT-ADMITTED";
+    const head = `[${LABEL[o.resolution.action]}] ${strength} ${o.trigger.scope} ${o.trigger.threadId} by ${who}`;
+    switch (o.resolution.action) {
+        case "accept":
+            return `${head} → accepted (${o.resolution.basis})`;
+        case "shadow":
+            return `${head} → shadow record only, nothing executed (${o.resolution.basis})`;
+        case "reject":
+            return `${head} (${o.resolution.basis})`;
+    }
+}
+//# sourceMappingURL=runner.js.map

package/dist/runner.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"runner.js","sourceRoot":"","sources":["../src/runner.ts"],"names":[],"mappings":"AAAA,kGAAkG;AAClG,kGAAkG;AAGlG,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAqD,MAAM,WAAW,CAAC;AAQ9G,MAAM,UAAU,QAAQ,CAAC,OAAgB,EAAE,MAAc,EAAE,UAAsB;IAC/E,MAAM,IAAI,GAAG,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3C,MAAM,UAAU,GAAG,gBAAgB,CAAC,MAAM,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;IAC9D,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;AACvC,CAAC;AAED,MAAM,KAAK,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,QAAQ,EAAW,CAAC;AAEtF,MAAM,UAAU,aAAa,CAAC,CAAc;IAC1C,MAAM,GAAG,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IAChF,MAAM,QAAQ,GAAG,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC;IAClF,MAAM,IAAI,GAAG,IAAI,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC,CAAC,OAAO,CAAC,QAAQ,OAAO,GAAG,EAAE,CAAC;IAC9G,QAAQ,CAAC,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC;QAC5B,KAAK,QAAQ;YACX,OAAO,GAAG,IAAI,gBAAgB,CAAC,CAAC,UAAU,CAAC,KAAK,GAAG,CAAC;QACtD,KAAK,QAAQ;YACX,OAAO,GAAG,IAAI,4CAA4C,CAAC,CAAC,UAAU,CAAC,KAAK,GAAG,CAAC;QAClF,KAAK,QAAQ;YACX,OAAO,GAAG,IAAI,KAAK,CAAC,CAAC,UAAU,CAAC,KAAK,GAAG,CAAC;IAC7C,CAAC;AACH,CAAC"}

package/dist/usage.d.ts ADDED Viewed

@@ -0,0 +1,5 @@
+export declare const USAGE = "dsh-super-agent \u2014 admission control, observe mode & tickets for any CLI coding agent\n\nUsage: dsh-super-agent <command> [options]\n\nCommands:\n  poll      one pass: poll GitHub \u2192 gate \u2192 (assessment) \u2192 record; --post also drains queued replies\n  work      claim queued tickets \u2192 run the executor in a worktree \u2192 report\n  watch     poll + work + panel as one daemon (Ctrl-C stops after the current cycle)\n  tickets   list tickets; \"tickets stop <id>\" ends one\n  panel     serve the awaiting-human panel (http://127.0.0.1:8787)\n  help      show this usage\n\nCommon options:\n  --repo owner/name         repository to watch\n  --agent-login <login>     the agent's GitHub login (mention detection)\n  --config <file>           policy config        (default policy.json, auto-scaffolded from examples/)\n  --executor-config <file>  executor config      (default executor.json, auto-scaffolded from examples/)\n  --db <file>               state database       (default .state/engine.db)\n  --token <token>           GitHub token (or env GITHUB_TOKEN)\n  --assessment <mode>       stub-positive | stub-negative | llm\n  --interval <seconds>      watch poll interval (\u00B120% jitter)\n  --no-panel                watch without the panel server\n  --post                    poll also posts queued replies (needs a token)\n\nEnvironment: GITHUB_TOKEN, ASSESS_BASE_URL, ASSESS_MODEL, ASSESS_API_KEY, PANEL_PORT.\nDocs: https://github.com/vicfei/dsh-super-agent#quick-start";
+export declare function examplePath(name: string): string | null;
+/** Copy the packaged example to `target` when neither exists yet. True ⇒ caller should tell the user to edit & rerun. */
+export declare function scaffoldFromExample(target: string, example: string): boolean;
+export declare const NO_TOKEN_HINT = "[warn] GITHUB_TOKEN is not set \u2014 anonymous mode: public repos only, ~60 requests/hour,\n       replies & PRs stay queued in the local outbox until a token appears.\n       start with a read-only token: https://github.com/settings/personal-access-tokens/new\n       then: export GITHUB_TOKEN=github_pat_\u2026";

package/dist/usage.js ADDED Viewed

@@ -0,0 +1,50 @@
+// Usage text and first-run bootstrap helpers — the DX surface of the CLI (M5-5, issue #19).
+// Example configs ship in the npm package (package.json "files"), resolved relative to this
+// module so it works from src/ (tsx), dist/ (installed bin) and any cwd.
+import { copyFileSync, existsSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+export const USAGE = `dsh-super-agent — admission control, observe mode & tickets for any CLI coding agent
+Usage: dsh-super-agent <command> [options]
+Commands:
+  poll      one pass: poll GitHub → gate → (assessment) → record; --post also drains queued replies
+  work      claim queued tickets → run the executor in a worktree → report
+  watch     poll + work + panel as one daemon (Ctrl-C stops after the current cycle)
+  tickets   list tickets; "tickets stop <id>" ends one
+  panel     serve the awaiting-human panel (http://127.0.0.1:8787)
+  help      show this usage
+Common options:
+  --repo owner/name         repository to watch
+  --agent-login <login>     the agent's GitHub login (mention detection)
+  --config <file>           policy config        (default policy.json, auto-scaffolded from examples/)
+  --executor-config <file>  executor config      (default executor.json, auto-scaffolded from examples/)
+  --db <file>               state database       (default .state/engine.db)
+  --token <token>           GitHub token (or env GITHUB_TOKEN)
+  --assessment <mode>       stub-positive | stub-negative | llm
+  --interval <seconds>      watch poll interval (±20% jitter)
+  --no-panel                watch without the panel server
+  --post                    poll also posts queued replies (needs a token)
+Environment: GITHUB_TOKEN, ASSESS_BASE_URL, ASSESS_MODEL, ASSESS_API_KEY, PANEL_PORT.
+Docs: https://github.com/vicfei/dsh-super-agent#quick-start`;
+const examplesDir = join(dirname(fileURLToPath(import.meta.url)), "..", "examples");
+export function examplePath(name) {
+    const p = join(examplesDir, name);
+    return existsSync(p) ? p : null;
+}
+/** Copy the packaged example to `target` when neither exists yet. True ⇒ caller should tell the user to edit & rerun. */
+export function scaffoldFromExample(target, example) {
+    const src = examplePath(example);
+    if (!src || existsSync(target))
+        return false;
+    copyFileSync(src, target);
+    return true;
+}
+export const NO_TOKEN_HINT = `[warn] GITHUB_TOKEN is not set — anonymous mode: public repos only, ~60 requests/hour,
+       replies & PRs stay queued in the local outbox until a token appears.
+       start with a read-only token: https://github.com/settings/personal-access-tokens/new
+       then: export GITHUB_TOKEN=github_pat_…`;
+//# sourceMappingURL=usage.js.map

package/dist/usage.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"usage.js","sourceRoot":"","sources":["../src/usage.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,4FAA4F;AAC5F,yEAAyE;AAEzE,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,CAAC,MAAM,KAAK,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;4DAyBuC,CAAC;AAE7D,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;AAEpF,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,MAAM,CAAC,GAAG,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;IAClC,OAAO,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAClC,CAAC;AAED,yHAAyH;AACzH,MAAM,UAAU,mBAAmB,CAAC,MAAc,EAAE,OAAe;IACjE,MAAM,GAAG,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;IACjC,IAAI,CAAC,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC;QAAE,OAAO,KAAK,CAAC;IAC7C,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAC1B,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,CAAC,MAAM,aAAa,GAAG;;;8CAGiB,CAAC"}

package/dist/watch.d.ts ADDED Viewed

@@ -0,0 +1,19 @@
+import type { Policy, Trigger } from "./domain.js";
+import type { Engine } from "./engine.js";
+import type { GitHubSource } from "./github/source.js";
+import type { Executor } from "./executor.js";
+import type { GitHubClient } from "./github/client.js";
+export type AssessmentFn = (t: Trigger) => Promise<"positive" | "negative"> | "positive" | "negative";
+export interface WatchOptions {
+    engine: Engine;
+    source: GitHubSource;
+    executor: Executor;
+    client: GitHubClient | null;
+    repo: string;
+    policy: Policy;
+    assessment: AssessmentFn;
+    intervalMs?: number;
+    cycles?: number;
+    log?: (line: string) => void;
+}
+export declare function runWatch(opts: WatchOptions): Promise<void>;

package/dist/watch.js ADDED Viewed

@@ -0,0 +1,53 @@
+// watch — the daemon: poll → gate/assess → ingest → claim → execute → report → drain,
+// one process, forever (or until SIGINT/SIGTERM — the current cycle finishes first).
+// Interval gets jitter so a fleet of watchers doesn't thunder-herd the API; errors
+// back off exponentially up to a 10-minute cap instead of dying.
+import { classify, formatOutcome } from "./runner.js";
+import { runWork } from "./work.js";
+const MAX_BACKOFF_MS = 10 * 60 * 1000;
+export async function runWatch(opts) {
+    const log = opts.log ?? ((l) => console.log(l));
+    const base = opts.intervalMs ?? 30_000;
+    let stopped = false;
+    const stop = () => { stopped = true; };
+    process.once("SIGINT", stop);
+    process.once("SIGTERM", stop);
+    let backoffMs = 0;
+    for (let cycle = 1; !stopped && (opts.cycles === undefined || cycle <= opts.cycles); cycle++) {
+        try {
+            const hadEvents = await runCycle(opts, log);
+            backoffMs = 0; // any completed cycle means the world still works
+            if (hadEvents)
+                continue; // no sleep after a busy cycle — go again immediately
+        }
+        catch (e) {
+            backoffMs = backoffMs === 0 ? base : Math.min(backoffMs * 2, MAX_BACKOFF_MS);
+            log(`[watch] cycle ${cycle} failed: ${e instanceof Error ? e.message : e} — backing off ${Math.round(backoffMs / 1000)}s`);
+        }
+        if (stopped || opts.cycles !== undefined && cycle >= opts.cycles)
+            break;
+        const jitter = 1 + (Math.random() * 0.4 - 0.2);
+        await new Promise((r) => setTimeout(r, Math.round((backoffMs || base) * jitter)));
+    }
+}
+async function runCycle(opts, log) {
+    const { engine, source, executor, client, repo, policy } = opts;
+    const { triggers, next } = await source.collect(engine.positions(), { exclude: engine.selfPosted() });
+    const batch = [];
+    for (const t of triggers)
+        batch.push(classify(t, policy, await opts.assessment(t)));
+    for (const outcome of batch)
+        log(formatOutcome(outcome));
+    const report = engine.ingest(batch, next);
+    for (const refusal of report.refusals)
+        log(`[REFUSED] ${refusal}`);
+    const reports = await runWork(engine, executor, repo, client);
+    for (const r of reports)
+        log(`#${r.ticketId} [${r.outcome}] ${r.detail}`);
+    if (batch.length > 0 || reports.length > 0 || report.refusals.length > 0) {
+        log(`— cycle: fresh=${report.fresh} opened=${report.ticketsOpened} resumed=${report.resumed} worked=${reports.length}`);
+        return true;
+    }
+    return false;
+}
+//# sourceMappingURL=watch.js.map

package/dist/watch.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"watch.js","sourceRoot":"","sources":["../src/watch.ts"],"names":[],"mappings":"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"}

package/dist/work.d.ts ADDED Viewed

@@ -0,0 +1,27 @@
+import type { Engine } from "./engine.js";
+import { Executor, type ExecutorResult } from "./executor.js";
+import type { GitHubClient } from "./github/client.js";
+export interface WorkReport {
+    ticketId: number;
+    assignmentId: number;
+    outcome: "done" | "failed" | "refused";
+    detail: string;
+}
+export interface DeliveryOutcome {
+    prUrl?: string;
+    error?: string;
+}
+/**
+ * PR delivery (docs/003: results return via the Source): if the worker committed anything
+ * beyond its base, push the ticket branch and open a pull request. Delivery failures
+ * degrade gracefully — the work is done; only the packaging failed.
+ */
+export declare function deliverPullRequest(client: GitHubClient, repo: string, ticket: {
+    id: number;
+    threadId: string;
+}, trigger: {
+    body: string;
+    author: string;
+}, result: ExecutorResult): Promise<DeliveryOutcome>;
+export declare function runWork(engine: Engine, executor: Executor, repo: string, client: GitHubClient | null): Promise<WorkReport[]>;
+export declare function drainReplyEffects(engine: Engine, client: GitHubClient, repo: string): Promise<void>;

package/dist/work.js ADDED Viewed

@@ -0,0 +1,127 @@
+// Work orchestration — claim queued tickets, run each in its worktree via the configured CLI,
+// record the assignment, report into the thread (docs/003: reports; docs/004: report style).
+// Runs after commit: the Engine state transitions first, the subprocess and posting after.
+import { clipReply } from "./clip.js";
+import { spawn } from "node:child_process";
+/** git, quietly — resolves with stdout or throws with stderr context. */
+function git(dir, args) {
+    return new Promise((resolve, reject) => {
+        const child = spawn("git", ["-C", dir, ...args], { stdio: ["ignore", "pipe", "pipe"] });
+        let out = "", err = "";
+        child.stdout.on("data", (d) => (out += d));
+        child.stderr.on("data", (d) => (err += d));
+        child.on("close", (code) => (code === 0 ? resolve(out.trim()) : reject(new Error(`git ${args.join(" ")} → ${code}: ${err.trim().slice(0, 200)}`))));
+    });
+}
+/**
+ * PR delivery (docs/003: results return via the Source): if the worker committed anything
+ * beyond its base, push the ticket branch and open a pull request. Delivery failures
+ * degrade gracefully — the work is done; only the packaging failed.
+ */
+export async function deliverPullRequest(client, repo, ticket, trigger, result) {
+    try {
+        const count = Number(await git(result.worktree, ["rev-list", "--count", `${result.baseSha}..HEAD`]));
+        if (count === 0)
+            return {}; // nothing to deliver
+        const branch = `dsh/ticket-${ticket.id}`;
+        await git(result.worktree, ["push", "origin", `HEAD:refs/heads/${branch}`]);
+        const base = await client.getDefaultBranch(repo);
+        const firstLine = trigger.body.trim().split("\n")[0].slice(0, 72) || "ticket work";
+        const pr = await client.createPullRequest(repo, {
+            title: `Ticket #${ticket.id}: ${firstLine}`,
+            head: branch,
+            base,
+            body: [
+                `This is by an automated agent, not a human.`,
+                ``,
+                `Ticket #${ticket.id} — opened by @${trigger.author} in ${ticket.threadId}.`,
+                ``,
+                `**Request**`,
+                ``,
+                trigger.body.trim().slice(0, 500) || "(no body)",
+                ``,
+                `Worker output excerpt:`,
+                ``,
+                "```",
+                result.output.trim().slice(-600),
+                "```",
+            ].join("\n"),
+        });
+        return { prUrl: pr.html_url };
+    }
+    catch (e) {
+        return { error: e instanceof Error ? e.message : String(e) };
+    }
+}
+export async function runWork(engine, executor, repo, client) {
+    const queued = engine.claimQueued(executor.cfg.maxWorkers); // slots
+    const reports = [];
+    for (const t of queued) {
+        const assignmentId = engine.startAssignment(t.id, ""); // running — worktree filled on success
+        let result;
+        try {
+            result = await executor.run({ id: t.id, threadId: t.threadId }, { body: t.body, author: t.author }, repo);
+        }
+        catch (e) {
+            const detail = e instanceof Error ? e.message : String(e);
+            engine.endAssignment(assignmentId, null, false, detail);
+            engine.enqueueReply(`ticket-report:${t.id}:${assignmentId}`, t.threadId, clipReply(`Ticket #${t.id} could not run: ${detail}. Awaiting a person. This is by an automated agent, not a human.`, 150));
+            reports.push({ ticketId: t.id, assignmentId, outcome: "refused", detail });
+            continue;
+        }
+        engine.endAssignment(assignmentId, result.exitCode, result.timedOut, result.output);
+        const ok = !result.timedOut && result.exitCode === 0;
+        if (ok) {
+            engine.completeTicket(t.id);
+            const delivery = client ? await deliverPullRequest(client, repo, t, { body: t.body, author: t.author }, result) : {};
+            let body = reportBody(t.id, result);
+            if (delivery.prUrl)
+                body += `\n\nPR: ${delivery.prUrl}`;
+            if (delivery.error)
+                body += `\n\n(delivery failed: ${delivery.error})`;
+            engine.enqueueReply(`ticket-report:${t.id}:${assignmentId}`, t.threadId, body);
+            reports.push({ ticketId: t.id, assignmentId, outcome: "done", detail: delivery.prUrl ? `exit 0 · PR opened` : "exit 0" });
+        }
+        else {
+            engine.enqueueReply(`ticket-report:${t.id}:${assignmentId}`, t.threadId, reportBody(t.id, result));
+            reports.push({
+                ticketId: t.id, assignmentId, outcome: "failed",
+                detail: result.timedOut ? "timeout" : `exit ${result.exitCode}`,
+            });
+        }
+    }
+    if (client)
+        await drainReplyEffects(engine, client, repo);
+    return reports;
+}
+function reportBody(ticketId, r) {
+    const failed = r.timedOut || r.exitCode !== 0;
+    const status = r.timedOut ? "timed out after the background cap" : `exit ${r.exitCode}`;
+    const tail = r.output.trim().slice(-400);
+    const excerpt = tail ? `\n\n\`\`\`\n${tail}\n\`\`\`` : "";
+    return clipReply(`Ticket #${ticketId} ${failed ? "failed" : "done"} (${status}).${failed ? " Awaiting a person." : ""} This is by an automated agent, not a human.${excerpt}`, 150);
+}
+export async function drainReplyEffects(engine, client, repo) {
+    for (const fx of engine.takeDue()) {
+        if (fx.kind !== "reply") {
+            engine.completeEffect(fx.id);
+            continue;
+        }
+        const p = fx.payload;
+        if (p.issueNumber === null) {
+            engine.failEffect(fx.id, "cannot resolve issue number from thread", false);
+            continue;
+        }
+        try {
+            const { id } = await client.postIssueComment(repo, p.issueNumber, p.body);
+            engine.completeEffect(fx.id);
+            engine.markSelfPosted(id); // never re-ingest our own comment
+            console.log(`[POSTED] ${fx.key} → ${repo}#${p.issueNumber}`);
+        }
+        catch (e) {
+            engine.failEffect(fx.id, e instanceof Error ? e.message : String(e));
+            console.error(`[POST-FAILED] ${fx.key}: ${e instanceof Error ? e.message : e} (will back off)`);
+        }
+    }
+}
+//# sourceMappingURL=work.js.map

package/dist/work.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"work.js","sourceRoot":"","sources":["../src/work.ts"],"names":[],"mappings":"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"}

package/docs/demo.gif ADDED Viewed

Binary file

package/examples/executor.json ADDED Viewed

@@ -0,0 +1,8 @@
+{
+  "command": "claude -p \"$(cat \"$DSH_PROMPT_FILE\")\"",
+  "repoDir": ".",
+  "workRoot": ".state/work",
+  "timeoutMs": 1800000,
+  "maxWorkers": 1,
+  "blockedCommands": ["sudo", "rm -rf /", "curl | sh"]
+}

package/examples/policy.json ADDED Viewed

@@ -0,0 +1,14 @@
+{
+  "version": 1,
+  "allowedList": ["vicfei"],
+  "botList": ["github-actions", "dependabot"],
+  "acceptMode": "observe",
+  "table": [
+    { "scope": "issue",          "listedNotAddressing": "inferred", "unlistedAddressing": "ignore", "unlistedNotAddressing": "ignore" },
+    { "scope": "issue_comment",  "listedNotAddressing": "inferred", "unlistedAddressing": "ignore", "unlistedNotAddressing": "ignore" },
+    { "scope": "pr",             "listedNotAddressing": "inferred", "unlistedAddressing": "ignore", "unlistedNotAddressing": "ignore" },
+    { "scope": "pr_comment",     "listedNotAddressing": "inferred", "unlistedAddressing": "ignore", "unlistedNotAddressing": "ignore" },
+    { "scope": "review_comment", "listedNotAddressing": "inferred", "unlistedAddressing": "ignore", "unlistedNotAddressing": "ignore" },
+    { "scope": "ci",             "listedNotAddressing": "ignore",   "unlistedAddressing": "ignore", "unlistedNotAddressing": "ignore" }
+  ]
+}

package/package.json CHANGED Viewed

@@ -1,6 +1,45 @@
 {
   "name": "@vicfei/dsh-super-agent",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.5.1",
+  "description": "Admission control, observe mode & tickets for any CLI coding agent — independent implementation of the DeepSeek Super-agent design",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/vicfei/dsh-super-agent.git"
+  },
+  "type": "module",
+  "scripts": {
+    "test": "vitest run",
+    "build": "tsc -p tsconfig.json && cp src/panel.html dist/panel.html",
+    "poll": "tsx src/cli.ts poll",
+    "tickets": "tsx src/cli.ts tickets",
+    "work": "tsx src/cli.ts work",
+    "panel": "tsx src/cli.ts panel",
+    "watch": "tsx src/cli.ts watch",
+    "prepack": "npm run build"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^9.6.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.6.0",
+    "vitest": "^2.1.0"
+  },
+  "dependencies": {
+    "better-sqlite3": "^12.11.1"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "dsh-super-agent": "dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "examples",
+    "docs/demo.gif",
+    "README.md",
+    "README.zh-CN.md",
+    "LICENSE"
+  ]
+}