wicked-core-ts 0.1.0 → 0.2.0

package/index.d.ts

@@ -20,6 +20,11 @@ export interface LaunchOptions {
   humanConfirm?: string
   /** The id of a registered repo to run within (creates an isolated worktree). Omit for a repo-less run. */
   repoRef?: string
+  /**
+   * A registered `WorkflowDef` id (`feature` | `bug` | `migration` or a drop-in). When set, planning
+   * is data-driven from the def's phases; omit for the free-text planner.
+   */
+  workflow?: string
 }
 /**
  * A handle to a wicked-core runtime. Construct with [`Core::spawn`] (production engine: real
@@ -95,6 +100,48 @@ export declare class Core {
   registerRepo(name: string, rootPath: string): Promise<string>
   /** List every registered repository, as a JSON array of `RepoEntry` objects. */
   listRepos(): Promise<string>
+  /** All registered governance policies, as a JSON array of `Policy` objects. */
+  listPolicies(): Promise<string>
+  /** All conformance rules on the store (Pattern + Policy types), as a JSON array. */
+  listConformanceRules(): Promise<string>
+  /** All conformance claims (governance decisions) on the store, as a JSON array. */
+  listConformanceClaims(): Promise<string>
+  /**
+   * Upsert a governance policy. `policy_json` is a JSON-serialized `Policy` object
+   * (fields: id, kind, applies_to, effect, trigger, severity, criteria, rule, obligations).
+   * Validates server-side (fails closed on deny_unknown_fields + required fields). Idempotent
+   * on stable id — calling twice with the same id and payload is a no-op.
+   */
+  upsertPolicy(policyJson: string): Promise<string>
+  /**
+   * Upsert a conformance rule. `rule_json` is a JSON-serialized `ConformanceRule` object
+   * (fields: id, rule_type, statement, severity, confidence, targets, provenance).
+   * Validates server-side (INV-C1/C2/C4). Idempotent on stable id.
+   */
+  upsertConformanceRule(ruleJson: string): Promise<string>
+  /**
+   * Register (or replace) a workflow definition in the actor's runtime registry. `json` is a
+   * JSON-serialised `WorkflowDef` object (fields: id, description, phases — see the wicked-core
+   * workflow schema). Validates server-side (id + ≥1 phase required); rejects invalid JSON or a
+   * structurally invalid def. Returns the registered workflow id. Idempotent on id — calling
+   * twice replaces the first registration. The def is immediately visible to the next `launchRun`
+   * call; no process restart required.
+   */
+  registerWorkflow(json: string): Promise<string>
+  /**
+   * Recall which conformance rules apply to the given `query_json` (a JSON-serialized
+   * `RuleQuery` — fields: language, layer, framework, severity, rule_type; all optional).
+   * An empty or whitespace `query_json` is treated as an all-rules query (no facet filters).
+   * Opens a read-only connection — does not block the single-writer actor. Returns a JSON
+   * array of `ConformanceRule` objects, severity-first then id.
+   */
+  recallRulesPreview(queryJson: string): Promise<string>
+  /**
+   * Front-half coverage gate report — JSON-serialized `CoverageReport`, or the JSON literal
+   * `null` when the store has no domain-model nodes yet. Opens a read-only connection so it
+   * never blocks the single-writer actor.
+   */
+  getCoverageReport(): Promise<string>
   /**
    * Open a PTY terminal session running `cmd` (or the login shell if omitted) in `cwd`, sized
    * `cols`x`rows`. `governed=false` is a loud, opt-in UNGOVERNED operator shell that bypasses the
@@ -120,6 +167,22 @@ export declare class Core {
    * `terminalExited` event is emitted. Rejects on an unknown id.
    */
   closeTerminal(id: string): Promise<string>
+  /**
+   * Inject an operator message into one or all active PTY workers for a run.
+   *
+   * `target` is either `"all"` (write to every PTY session for the run) or a CLI key string
+   * (write only to that CLI's session). ACP-backed sessions have no PTY and are skipped with a
+   * warning. Fires [`CoreEvent::WorkerMessageInjected`] for each successful write.
+   */
+  injectWorkerMessage(runId: string, message: string, target: string): Promise<unknown>
+  /**
+   * Stop the current worker for `ord` in run `run_id` and re-dispatch it.
+   *
+   * `newCli` is either a CLI key string (re-dispatch immediately to that CLI) or `null` (re-run
+   * the council and let it pick). Returns `"ok"` when the command has been queued; the
+   * [`CoreEvent::UnitReassigned`] event confirms the reassignment.
+   */
+  reassignUnit(runId: string, ord: number, newCli?: string | undefined | null): Promise<unknown>
 }
 /**
  * A live event subscription returned by [`Core::subscribe`]. Owns the FIFO pump thread + its

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wicked-core-ts",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Node/TypeScript bindings (napi-rs) for wicked-core: drive the in-process orchestration engine from JS/TS.",
   "license": "MIT",
   "repository": {
@@ -41,11 +41,11 @@
     "smoke:all": "node smoke.mjs && node smoke-lifecycle.mjs && node smoke-terminal.mjs"
   },
   "optionalDependencies": {
-    "wicked-core-ts-darwin-arm64": "0.1.0",
-    "wicked-core-ts-darwin-x64": "0.1.0",
-    "wicked-core-ts-linux-arm64-gnu": "0.1.0",
-    "wicked-core-ts-linux-x64-gnu": "0.1.0",
-    "wicked-core-ts-win32-x64-msvc": "0.1.0"
+    "wicked-core-ts-darwin-arm64": "0.2.0",
+    "wicked-core-ts-darwin-x64": "0.2.0",
+    "wicked-core-ts-linux-arm64-gnu": "0.2.0",
+    "wicked-core-ts-linux-x64-gnu": "0.2.0",
+    "wicked-core-ts-win32-x64-msvc": "0.2.0"
   },
   "devDependencies": {
     "@napi-rs/cli": "^2.18.4"