wotann 0.5.0 → 0.5.39

package/dist/skills/sop-template.d.ts

@@ -0,0 +1,85 @@
+/**
+ * sop-template — canonical 4-section SOP shape (启动/选择/执行/收尾).
+ *
+ * Ported from GenericAgent's `memory/autonomous_operation_sop.md` and
+ * its siblings (`plan_sop.md`, `supervisor_sop.md`, `verify_sop.md`).
+ * Every upstream SOP follows the same four-act structure:
+ *
+ *   启动 (start)     — open the SOP, set the initial checkpoint
+ *   选择 (choose)    — pick the next task from todo / history
+ *   执行 (execute)   — do the work, ≤30 turns, small steps
+ *   收尾 (finalize)  — write the report, complete_task, set_todo
+ *
+ * WOTANN's `sop-crystallizer.ts` currently emits a free-form procedure
+ * block. This template provides the SHAPE that crystallizer should
+ * eventually adopt: the same 4-section structure as the GenericAgent
+ * memory bank, so SOPs written by WOTANN are interchangeable with the
+ * upstream skill library.
+ *
+ * The template is intentionally:
+ *   - English-first (no Chinese in the public surface)
+ *   - Markdown only (no YAML frontmatter — the caller wraps it)
+ *   - Token-frugal (each section is a short prompt-ready chunk)
+ *
+ * Quality bars honoured:
+ *   - QB #7  per-call state: `renderSOPTemplate` is a pure function.
+ *     No I/O, no globals, no caches.
+ *   - QB #6  honest stubs: every field is required-and-rendered or
+ *     gracefully defaulted; we never silently drop the `steps` array.
+ *   - QB #14 commit-claim verification: the template string and the
+ *     renderer are both covered by real-code-path tests.
+ *
+ * No I/O. Pure string assembly.
+ */
+/**
+ * The canonical 4-section SOP template, as a raw string. The four
+ * sections are emitted as `## Start`, `## Choose`, `## Execute`, and
+ * `## Finalize` headers, with placeholder bullets explaining the
+ * intent of each section.
+ *
+ * Use `renderSOPTemplate(...)` to fill in a concrete trajectory.
+ * Use this constant directly when you want a blank template (e.g. for
+ * a user to fill in by hand).
+ *
+ * The template is exported so callers can:
+ *   - inline it in tests as a baseline
+ *   - prepend it to a system prompt for skill authoring
+ *   - render it verbatim into a "blank SOP" placeholder file
+ */
+export declare const SOP_TEMPLATE: string;
+/**
+ * Input shape for `renderSOPTemplate`. The three fields cover the
+ * three placeholders in `SOP_TEMPLATE`.
+ */
+export interface SOPTrajectory {
+    /** Free-form task title, used as the document's H1 heading. */
+    readonly task: string;
+    /**
+     * The concrete steps that fill the Execute section, in order. Each
+     * step is rendered as a markdown bullet. The array is `readonly` to
+     * signal that the renderer never mutates it.
+     */
+    readonly steps: readonly string[];
+    /** One-line outcome of the trajectory ("succeeded", "wrote 3 files", …). */
+    readonly outcome: string;
+}
+/**
+ * Render the template with a concrete trajectory. Returns a complete
+ * Markdown document with all four section headings populated.
+ *
+ * Behaviour contract:
+ *   - `task` is rendered verbatim into the H1. An empty `task` is
+ *     replaced with "Untitled task" so the H1 is never literally "# ".
+ *   - `steps` is rendered as a list of markdown bullets. An empty
+ *     `steps` array produces a single placeholder bullet
+ *     "- (no steps recorded)" — silent omission would let a malformed
+ *     trajectory produce a malformed SOP.
+ *   - `outcome` is rendered verbatim. Empty `outcome` becomes
+ *     "(no outcome recorded)" for the same reason.
+ *
+ * The function does NOT escape markdown special characters in the
+ * inputs; callers feeding untrusted text should sanitize beforehand.
+ * This matches the existing `sop-crystallizer.ts` behaviour.
+ */
+export declare function renderSOPTemplate(trajectory: SOPTrajectory): string;
+//# sourceMappingURL=sop-template.d.ts.map

package/dist/skills/sop-template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sop-template.d.ts","sourceRoot":"","sources":["../../src/skills/sop-template.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,YAAY,QAyBb,CAAC;AAEb;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,+DAA+D;IAC/D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,4EAA4E;IAC5E,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,aAAa,GAAG,MAAM,CAkBnE"}

package/dist/skills/sop-template.js

@@ -0,0 +1,106 @@
+/**
+ * sop-template — canonical 4-section SOP shape (启动/选择/执行/收尾).
+ *
+ * Ported from GenericAgent's `memory/autonomous_operation_sop.md` and
+ * its siblings (`plan_sop.md`, `supervisor_sop.md`, `verify_sop.md`).
+ * Every upstream SOP follows the same four-act structure:
+ *
+ *   启动 (start)     — open the SOP, set the initial checkpoint
+ *   选择 (choose)    — pick the next task from todo / history
+ *   执行 (execute)   — do the work, ≤30 turns, small steps
+ *   收尾 (finalize)  — write the report, complete_task, set_todo
+ *
+ * WOTANN's `sop-crystallizer.ts` currently emits a free-form procedure
+ * block. This template provides the SHAPE that crystallizer should
+ * eventually adopt: the same 4-section structure as the GenericAgent
+ * memory bank, so SOPs written by WOTANN are interchangeable with the
+ * upstream skill library.
+ *
+ * The template is intentionally:
+ *   - English-first (no Chinese in the public surface)
+ *   - Markdown only (no YAML frontmatter — the caller wraps it)
+ *   - Token-frugal (each section is a short prompt-ready chunk)
+ *
+ * Quality bars honoured:
+ *   - QB #7  per-call state: `renderSOPTemplate` is a pure function.
+ *     No I/O, no globals, no caches.
+ *   - QB #6  honest stubs: every field is required-and-rendered or
+ *     gracefully defaulted; we never silently drop the `steps` array.
+ *   - QB #14 commit-claim verification: the template string and the
+ *     renderer are both covered by real-code-path tests.
+ *
+ * No I/O. Pure string assembly.
+ */
+/**
+ * The canonical 4-section SOP template, as a raw string. The four
+ * sections are emitted as `## Start`, `## Choose`, `## Execute`, and
+ * `## Finalize` headers, with placeholder bullets explaining the
+ * intent of each section.
+ *
+ * Use `renderSOPTemplate(...)` to fill in a concrete trajectory.
+ * Use this constant directly when you want a blank template (e.g. for
+ * a user to fill in by hand).
+ *
+ * The template is exported so callers can:
+ *   - inline it in tests as a baseline
+ *   - prepend it to a system prompt for skill authoring
+ *   - render it verbatim into a "blank SOP" placeholder file
+ */
+export const SOP_TEMPLATE = [
+    "# {task}",
+    "",
+    "## Start",
+    "",
+    "- Read this SOP end-to-end before acting.",
+    "- Set the initial working checkpoint: task name + constraints + entry point.",
+    "",
+    "## Choose",
+    "",
+    "- Inspect history and TODO list to avoid duplicate work.",
+    "- Pick ONE concrete subtask; do not chain in this section.",
+    "",
+    "## Execute",
+    "",
+    "- {steps}",
+    "",
+    "## Finalize",
+    "",
+    "- Re-read this SOP to verify closeout coverage.",
+    "- Write the report and append memory-update suggestions.",
+    "- Run `complete_task` with the outcome line.",
+    "- Run `set_todo` to mark this entry done and queue the next one.",
+    "- Outcome: {outcome}",
+    "",
+].join("\n");
+/**
+ * Render the template with a concrete trajectory. Returns a complete
+ * Markdown document with all four section headings populated.
+ *
+ * Behaviour contract:
+ *   - `task` is rendered verbatim into the H1. An empty `task` is
+ *     replaced with "Untitled task" so the H1 is never literally "# ".
+ *   - `steps` is rendered as a list of markdown bullets. An empty
+ *     `steps` array produces a single placeholder bullet
+ *     "- (no steps recorded)" — silent omission would let a malformed
+ *     trajectory produce a malformed SOP.
+ *   - `outcome` is rendered verbatim. Empty `outcome` becomes
+ *     "(no outcome recorded)" for the same reason.
+ *
+ * The function does NOT escape markdown special characters in the
+ * inputs; callers feeding untrusted text should sanitize beforehand.
+ * This matches the existing `sop-crystallizer.ts` behaviour.
+ */
+export function renderSOPTemplate(trajectory) {
+    const task = typeof trajectory.task === "string" && trajectory.task.trim().length > 0
+        ? trajectory.task.trim()
+        : "Untitled task";
+    const stepsArr = Array.isArray(trajectory.steps) ? trajectory.steps : [];
+    const stepLines = stepsArr.length === 0 ? "(no steps recorded)" : stepsArr.map((s) => String(s)).join("\n- ");
+    const outcome = typeof trajectory.outcome === "string" && trajectory.outcome.length > 0
+        ? trajectory.outcome
+        : "(no outcome recorded)";
+    return SOP_TEMPLATE.replace("{task}", task)
+        .replace("{steps}", stepLines)
+        .replace("{outcome}", outcome);
+}
+//# sourceMappingURL=sop-template.js.map

package/dist/skills/sop-template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sop-template.js","sourceRoot":"","sources":["../../src/skills/sop-template.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,UAAU;IACV,EAAE;IACF,UAAU;IACV,EAAE;IACF,2CAA2C;IAC3C,8EAA8E;IAC9E,EAAE;IACF,WAAW;IACX,EAAE;IACF,0DAA0D;IAC1D,4DAA4D;IAC5D,EAAE;IACF,YAAY;IACZ,EAAE;IACF,WAAW;IACX,EAAE;IACF,aAAa;IACb,EAAE;IACF,iDAAiD;IACjD,0DAA0D;IAC1D,8CAA8C;IAC9C,kEAAkE;IAClE,sBAAsB;IACtB,EAAE;CACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAmBb;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,iBAAiB,CAAC,UAAyB;IACzD,MAAM,IAAI,GACR,OAAO,UAAU,CAAC,IAAI,KAAK,QAAQ,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC;QACtE,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE;QACxB,CAAC,CAAC,eAAe,CAAC;IAEtB,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IACzE,MAAM,SAAS,GACb,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAE9F,MAAM,OAAO,GACX,OAAO,UAAU,CAAC,OAAO,KAAK,QAAQ,IAAI,UAAU,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;QACrE,CAAC,CAAC,UAAU,CAAC,OAAO;QACpB,CAAC,CAAC,uBAAuB,CAAC;IAE9B,OAAO,YAAY,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC;SACxC,OAAO,CAAC,SAAS,EAAE,SAAS,CAAC;SAC7B,OAAO,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;AACnC,CAAC"}

package/dist/skills/wotann-skills-registry.d.ts

@@ -27,7 +27,7 @@
  * `operations` covers runbooks (incident response, deployments).
  * `research` covers multi-source investigation.
  */
-export type WotannSkillCategory = "quality" | "debugging" | "security" | "performance" | "testing" | "architecture" | "database" | "operations" | "research" | "document-creation";
+export type WotannSkillCategory = "quality" | "debugging" | "security" | "performance" | "testing" | "architecture" | "database" | "operations" | "research" | "document-creation" | "analysis" | "writing" | "data";
 /**
  * One skill entry. The `file` field is relative to the project root so
  * loaders can resolve `<projectDir>/<file>` directly.

package/dist/skills/wotann-skills-registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wotann-skills-registry.d.ts","sourceRoot":"","sources":["../../src/skills/wotann-skills-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,mBAAmB,GAC3B,SAAS,GACT,WAAW,GACX,UAAU,GACV,aAAa,GACb,SAAS,GACT,cAAc,GACd,UAAU,GACV,YAAY,GACZ,UAAU,GACV,mBAAmB,CAAC;AAExB;;;;;;;;;;GAUG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,CAAC;CACxC;AAID;;;;GAIG;AACH,eAAO,MAAM,aAAa,EAAE,SAAS,gBAAgB,EAkdpD,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAKjE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,mBAAmB,GAAG,SAAS,gBAAgB,EAAE,CAM3F;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,MAAM,EACb,KAAK,GAAE,MAAU,GAChB,SAAS,gBAAgB,EAAE,CAmB7B;AAED;;;GAGG;AACH,wBAAgB,cAAc,IAAI,SAAS,mBAAmB,EAAE,CAM/D;AAED;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAA6B,CAAC"}
+{"version":3,"file":"wotann-skills-registry.d.ts","sourceRoot":"","sources":["../../src/skills/wotann-skills-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,mBAAmB,GAC3B,SAAS,GACT,WAAW,GACX,UAAU,GACV,aAAa,GACb,SAAS,GACT,cAAc,GACd,UAAU,GACV,YAAY,GACZ,UAAU,GACV,mBAAmB,GAKnB,UAAU,GACV,SAAS,GACT,MAAM,CAAC;AAEX;;;;;;;;;;GAUG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,CAAC;CACxC;AAID;;;;GAIG;AACH,eAAO,MAAM,aAAa,EAAE,SAAS,gBAAgB,EAw+BpD,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAKjE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,mBAAmB,GAAG,SAAS,gBAAgB,EAAE,CAM3F;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,MAAM,EACb,KAAK,GAAE,MAAU,GAChB,SAAS,gBAAgB,EAAE,CAmB7B;AAED;;;GAGG;AACH,wBAAgB,cAAc,IAAI,SAAS,mBAAmB,EAAE,CAM/D;AAED;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAA6B,CAAC"}