@kindgi/api 0.1.4 → 0.1.5

package/dist/routes/proposals.d.ts

@@ -1,24 +1,32 @@
 import { Hono } from 'hono';
-import type { SupervisorBinding } from '../supervisor-binding.js';
+import type { Authorizer } from '../middleware/authorize.js';
+import { type ProposalFacts, type ProposalService, type ProposalServiceDeps } from '../proposal-service.js';
+import type { StoredProposal } from '../supervisor-binding.js';
 import type { AppEnv } from '../types.js';
+/** What the proposal lifecycle runs on besides its own store. */
+export type ProposalsRouteDeps = Omit<ProposalServiceDeps, 'store'>;
 /**
- * Supervisor proposals resource. Ships the full self-fix lifecycle
- * over HTTP: draft → dry-run → submit-review → apply / rollback /
- * withdraw — the complete supervisor loop.
+ * Improvement proposals (`/v1/proposals`): a change to one data block an
+ * agent version pins (new settings values, or a new prompt template),
+ * for one live scope, taken through the same comparison, gate and
+ * promotion as any other version (`createProposalService`).
  *
- * Persistence + runtime wiring is caller-plugged via
- * `SupervisorBinding` — the API package doesn't own supervisor
- * runtime, agent registry, HITL wiring, or eval invocation.
+ *   GET  /                 list (statuses derived): by agent, tier, status and live scope
+ *   GET  /:id              one
+ *   POST /                 a hand-written proposal (a draft)
+ *   POST /:id/evaluate     publish the block version and derive the agent
+ *                          version (inert until promoted), then compare it
+ *                          on a test set (202)
+ *   POST /:id/request      a gated promotion of the candidate for the scope
+ *                          (201 promoted, 202 in review, 422 gate-failed)
+ *   POST /:id/rollback     the scope goes back to what served it before
+ *   POST /:id/withdraw     closed by a person
  *
- * `supervisorId` scoping: every route requires an `X-Supervisor-Id`
- * request header. Missing / empty → `400 supervisor-header-missing`.
- *
- * State transitions: attempts to advance a proposal from a status
- * the runtime won't accept (e.g., apply on a proposal still in
- * `dry-running`) surface as `409 proposal-invalid-state-transition`.
- * This is a caller/state conflict per `docs/API-ROUTE-CONVENTIONS.md`
- * §4.3 — the request was well-formed but the resource is not in
- * the required state.
+ * Authorized on the proposal's agent: reading is `read`, drafting,
+ * evaluating and withdrawing are `publish` (they make versions), and
+ * requesting and rolling back are `promote`. A proposal the caller can't
+ * read answers 404, as one that doesn't exist.
  */
-export declare function proposalsRouter(binding: SupervisorBinding): Hono<AppEnv>;
+export declare function proposalsRouter(store: ProposalServiceDeps['store'], deps: ProposalsRouteDeps, authorizer?: Authorizer, mount?: (r: Hono<AppEnv>, service: ProposalService) => void): Hono<AppEnv>;
+export declare function serialize(p: StoredProposal, f: ProposalFacts): Record<string, unknown>;
 //# sourceMappingURL=proposals.d.ts.map

package/dist/routes/proposals.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"proposals.d.ts","sourceRoot":"","sources":["../../src/routes/proposals.ts"],"names":[],"mappings":"AAGA,OAAO,EAAgB,IAAI,EAAE,MAAM,MAAM,CAAC;AAY1C,OAAO,KAAK,EAMV,iBAAiB,EAClB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AA6B1C;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI,CAAC,MAAM,CAAC,CAuWxE"}
+{"version":3,"file":"proposals.d.ts","sourceRoot":"","sources":["../../src/routes/proposals.ts"],"names":[],"mappings":"AAGA,OAAO,EAAgB,IAAI,EAAE,MAAM,MAAM,CAAC;AAQ1C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,mBAAmB,EAIzB,MAAM,wBAAwB,CAAC;AAMhC,OAAO,KAAK,EAIV,cAAc,EACf,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAM1C,iEAAiE;AACjE,MAAM,MAAM,kBAAkB,GAAG,IAAI,CAAC,mBAAmB,EAAE,OAAO,CAAC,CAAC;AAQpE;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,mBAAmB,CAAC,OAAO,CAAC,EACnC,IAAI,EAAE,kBAAkB,EACxB,UAAU,CAAC,EAAE,UAAU,EACvB,KAAK,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,eAAe,KAAK,IAAI,GAC1D,IAAI,CAAC,MAAM,CAAC,CA2Md;AAqBD,wBAAgB,SAAS,CAAC,CAAC,EAAE,cAAc,EAAE,CAAC,EAAE,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA4BtF"}