@vibeiao/sdk 0.1.31 → 0.1.32

package/README.md

@@ -383,6 +383,129 @@ Routing policy after acceptance:
 - Primary: treasury-proxy route
 - Fallback: original provider API key only when primary route fails or is policy-blocked
 
+## Human App Reflective Loop Pack (First-class)
+
+Use the built-in pack for human app lifecycle runs:
+
+- phases: `research -> hypothesis -> build -> launch -> observe -> reflect -> iterate`
+- explicit per-phase inputs/outputs + go/no-go + KPI + rollback conditions
+- optional tool-choice policy with required rationale logging
+- trial evaluation rubric (research depth / iteration quality / outcome usefulness)
+
+```ts
+import {
+  createHumanAppLoopSpec,
+  scaffoldHumanAppLoopPack,
+  evaluateHumanAppTrial,
+} from '@vibeiao/sdk';
+
+const spec = createHumanAppLoopSpec();
+
+await scaffoldHumanAppLoopPack({
+  root: process.cwd(),
+  outputDir: 'projects/vibeiao/human-app-loop-pack',
+});
+
+const trial = evaluateHumanAppTrial({
+  id: 'trial-1',
+  evidence: {
+    researchNotesCount: 4,
+    hypothesisCount: 2,
+    experimentsRun: 1,
+    measurableKpiCount: 2,
+    rollbackPlanPresent: true,
+    shippedArtifactPresent: true,
+    iterationSteps: 1,
+  },
+});
+
+console.log(spec.schema, trial.pass, trial.weightedScore);
+```
+
+## Outcome-Bound Autonomous Flow (Hard Completion Gate)
+
+Use this when the task must not be considered done until it is truly live.
+
+Required completion gates:
+- public deploy URL exists
+- listing metadata is updated
+- external smoke check passes
+- evidence log path recorded
+- context-pack preflight passed
+
+```ts
+import {
+  evaluateOutcomeBoundRun,
+  assertOutcomeBoundCompleted,
+} from '@vibeiao/sdk';
+
+const status = evaluateOutcomeBoundRun({
+  runId: 'release-2026-02-18',
+  objective: 'Ship human app v1 live',
+  publicDeployUrl: 'https://example.com/app',
+  listingId: '<listing-id>',
+  listingUpdated: true,
+  externalSmokeCheck: { passed: true, checker: 'curl -I' },
+  evidenceLogPath: 'generated/evals/release/run.md',
+  contextPackPreflight: { passed: true, scope: 'release' },
+});
+
+// Throws if any hard gate is missing.
+assertOutcomeBoundCompleted({
+  runId: 'release-2026-02-18',
+  objective: 'Ship human app v1 live',
+  publicDeployUrl: 'https://example.com/app',
+  listingId: '<listing-id>',
+  listingUpdated: true,
+  externalSmokeCheck: { passed: true },
+  evidenceLogPath: 'generated/evals/release/run.md',
+  contextPackPreflight: { passed: true, scope: 'release' },
+});
+
+console.log(status.completed, status.failedGates);
+```
+
+## Strict Memory Runtime Preset (Safe Upgrade Path)
+
+Use this preset when you want SDK-level parity for strict memory discipline across agents.
+
+What it enforces (for complex/mutating tasks):
+- context-pack prepared
+- semantic recall confirmed
+- mutation approval preflight passed
+
+And it supports safe rollout modes:
+- `observe` (default): collect/validate behavior
+- `enforce`: hard block when required gates are missing
+
+```ts
+import {
+  createStrictMemoryRuntimePreset,
+  evaluateStrictMemoryExecution,
+  upgradeToStrictMemoryRuntimePreset,
+} from '@vibeiao/sdk';
+
+const preset = createStrictMemoryRuntimePreset();
+
+const evalResult = evaluateStrictMemoryExecution({
+  taskText: 'Deploy production release with listing migration and config writes',
+  isMutation: true,
+  contextPackPrepared: true,
+  semanticRecallConfirmed: true,
+  approvalPreflightPassed: true,
+}, preset);
+
+const upgrade = upgradeToStrictMemoryRuntimePreset({
+  current: preset,
+  targetMode: 'enforce',
+  backupCreated: true,
+  healthcheckPassed: true,
+  recentBlockRate: 0.1,
+});
+
+console.log(evalResult.allowed, upgrade.safe, upgrade.next.upgradePolicy.mode);
+```
+
 ## Compounding Memory Standard (Recommended Default)
 
 The SDK now includes a standardized layered memory scaffold modeled on long-running agent operation:

package/package.json

@@ -2,7 +2,7 @@
   "name": "@vibeiao/sdk",
   "private": false,
   "type": "module",
-  "version": "0.1.31",
+  "version": "0.1.32",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "exports": {