@happyvertical/smrt-ingestion 0.55.8 → 0.55.10

package/README.md

@@ -161,3 +161,24 @@ assignment ownership, and the maintained upload-to-domain-result browser fixture
 Optional explicit feedback and scoped example retrieval are documented in
 [FEEDBACK.md](FEEDBACK.md). Approval and execution outcomes remain separate from
 interpretation correctness; routing policy adoption is explicit and versioned.
+
+## Recipe preview
+
+`ingestion.inbox` and `ingestion.review` declare the user-facing inbox and
+review workflows for app discovery. The reference workflow and measured
+evaluation are now published, but the evaluation did not meet supported-reference
+quality gates and did not establish safety. Automation remains disabled. The
+recipes do not configure a source or provider, expose generic CRUD routes, or
+enable automatic execution. Mount `IntakeInbox` and `IntakeReview` with an
+authenticated `IntakeReviewHost`; [REVIEW.md](REVIEW.md) remains the source of
+truth for its scoped callbacks and freshness checks. See the [adoption
+checklist](../../docs/evaluation/3677-adoption.md) and [measured
+report](../../docs/evaluation/3677-measured-evaluation.md) for the release
+limits.
+
+The recipe manifest registers those existing browser components as
+`/ingestion/inbox` and `/ingestion/review` routes for a host to mount. The route
+metadata does not supply a host, source, provider, or demo fixture, and it does
+not change the preview-only status. Both recipes declare `both` runtime: their
+components render in a browser, while the authenticated review host and package
+dependency closure require a server.

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 import './__smrt-register__.js';
 export * from './dto.js';
 export * from './models.js';
+export { IngestionInboxRecipe, IngestionReviewRecipe, } from './recipes.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,wBAAwB,CAAC;AAEhC,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,wBAAwB,CAAC;AAEhC,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,OAAO,EACL,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -1,3 +1,90 @@
 import "./dto.js";
 import { IntakeAction, IntakeAnalysis, IntakeAnalysisAttempt, IntakeDeletion, IntakeDispatch, IntakeEvidence, IntakeExecution, IntakeFeedback, IntakeItem, IntakePlan, IntakeProposal, IntakeReviewDecision } from "./models.js";
-export { IntakeAction, IntakeAnalysis, IntakeAnalysisAttempt, IntakeDeletion, IntakeDispatch, IntakeEvidence, IntakeExecution, IntakeFeedback, IntakeItem, IntakePlan, IntakeProposal, IntakeReviewDecision };
+import { SmrtRecipe } from "@happyvertical/smrt-core";
+//#region src/recipes.ts
+var IngestionInboxRecipe = class extends SmrtRecipe {
+	static id = "ingestion.inbox";
+	static help = "./ingestion-inbox.recipe.md";
+	static label = "Ingestion inbox";
+	static summary = "Review incoming material and see which items need attention.";
+	static synonyms = [
+		"intake inbox",
+		"incoming documents",
+		"review queue"
+	];
+	static group = {
+		id: "ingestion",
+		label: "Ingestion",
+		summary: "Review incoming material safely before it can change records."
+	};
+	static section = {
+		id: "ingestion",
+		label: "Ingestion",
+		icon: "archive",
+		description: "Incoming material and its authenticated review workflow."
+	};
+	static models = [IntakeItem, IntakeEvidence];
+	static runtime = "both";
+	static surfaces = [{
+		kind: "route",
+		path: "/ingestion/inbox",
+		export: "@happyvertical/smrt-ingestion/svelte#IntakeInbox",
+		label: "Ingestion inbox"
+	}];
+	static nav = [{
+		label: "Ingestion inbox",
+		model: IntakeItem,
+		icon: "archive",
+		description: "Incoming material that needs authenticated attention.",
+		key: "inbox",
+		noun: "inbox item"
+	}];
+};
+var IngestionReviewRecipe = class extends SmrtRecipe {
+	static id = "ingestion.review";
+	static help = "./ingestion-review.recipe.md";
+	static label = "Ingestion review";
+	static summary = "Inspect evidence and approve, change, reject, or defer proposed actions.";
+	static synonyms = [
+		"intake review",
+		"proposal review",
+		"human approval"
+	];
+	static group = {
+		id: "ingestion",
+		label: "Ingestion",
+		summary: "Review incoming material safely before it can change records."
+	};
+	static section = {
+		id: "ingestion",
+		label: "Ingestion",
+		icon: "archive",
+		description: "Incoming material and its authenticated review workflow."
+	};
+	static models = [
+		IntakeItem,
+		IntakeEvidence,
+		IntakeAnalysis,
+		IntakeAction,
+		IntakeReviewDecision
+	];
+	static runtime = "both";
+	static surfaces = [{
+		kind: "route",
+		path: "/ingestion/review",
+		export: "@happyvertical/smrt-ingestion/svelte#IntakeReview",
+		label: "Ingestion review"
+	}];
+	static nav = [{
+		label: "Ingestion review",
+		model: IntakeReviewDecision,
+		icon: "fileText",
+		description: "Revision-bound decisions on proposed actions.",
+		key: "review",
+		noun: "review decision"
+	}];
+};
+//#endregion
+export { IngestionInboxRecipe, IngestionReviewRecipe, IntakeAction, IntakeAnalysis, IntakeAnalysisAttempt, IntakeDeletion, IntakeDispatch, IntakeEvidence, IntakeExecution, IntakeFeedback, IntakeItem, IntakePlan, IntakeProposal, IntakeReviewDecision };
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../src/recipes.ts"],"sourcesContent":["/**\n * Declared ingestion workflows for applications that provide an authenticated\n * intake-review host (#3725).\n *\n * These recipes describe the user-facing inbox and review work. They do not\n * expose the ingestion records as generic CRUD models: all reads and writes\n * continue through the host's scoped service callbacks.\n */\n\nimport { SmrtRecipe } from '@happyvertical/smrt-core';\nimport {\n  IntakeAction,\n  IntakeAnalysis,\n  IntakeEvidence,\n  IntakeItem,\n  IntakeReviewDecision,\n} from './models.js';\n\n/** Incoming material that needs authenticated human attention. */\nexport class IngestionInboxRecipe extends SmrtRecipe {\n  static id = 'ingestion.inbox';\n  static help = './ingestion-inbox.recipe.md';\n  static label = 'Ingestion inbox';\n  static summary =\n    'Review incoming material and see which items need attention.';\n  static synonyms = ['intake inbox', 'incoming documents', 'review queue'];\n  static group = {\n    id: 'ingestion',\n    label: 'Ingestion',\n    summary: 'Review incoming material safely before it can change records.',\n  };\n  static section = {\n    id: 'ingestion',\n    label: 'Ingestion',\n    icon: 'archive',\n    description: 'Incoming material and its authenticated review workflow.',\n  };\n  static models = [IntakeItem, IntakeEvidence];\n  // The route component renders in a browser, but its authenticated review host\n  // and package dependency closure require a server.\n  static runtime = 'both' as const;\n  static surfaces = [\n    {\n      kind: 'route',\n      path: '/ingestion/inbox',\n      export: '@happyvertical/smrt-ingestion/svelte#IntakeInbox',\n      label: 'Ingestion inbox',\n    },\n  ] as const;\n  static nav = [\n    {\n      label: 'Ingestion inbox',\n      model: IntakeItem,\n      icon: 'archive',\n      description: 'Incoming material that needs authenticated attention.',\n      key: 'inbox',\n      noun: 'inbox item',\n    },\n  ];\n}\n\n/** Revision-bound human review of proposed actions. */\nexport class IngestionReviewRecipe extends SmrtRecipe {\n  static id = 'ingestion.review';\n  static help = './ingestion-review.recipe.md';\n  static label = 'Ingestion review';\n  static summary =\n    'Inspect evidence and approve, change, reject, or defer proposed actions.';\n  static synonyms = ['intake review', 'proposal review', 'human approval'];\n  static group = {\n    id: 'ingestion',\n    label: 'Ingestion',\n    summary: 'Review incoming material safely before it can change records.',\n  };\n  static section = {\n    id: 'ingestion',\n    label: 'Ingestion',\n    icon: 'archive',\n    description: 'Incoming material and its authenticated review workflow.',\n  };\n  static models = [\n    IntakeItem,\n    IntakeEvidence,\n    IntakeAnalysis,\n    IntakeAction,\n    IntakeReviewDecision,\n  ];\n  // The route component renders in a browser, but its authenticated review host\n  // and package dependency closure require a server.\n  static runtime = 'both' as const;\n  static surfaces = [\n    {\n      kind: 'route',\n      path: '/ingestion/review',\n      export: '@happyvertical/smrt-ingestion/svelte#IntakeReview',\n      label: 'Ingestion review',\n    },\n  ] as const;\n  static nav = [\n    {\n      label: 'Ingestion review',\n      model: IntakeReviewDecision,\n      icon: 'fileText',\n      description: 'Revision-bound decisions on proposed actions.',\n      key: 'review',\n      noun: 'review decision',\n    },\n  ];\n}\n"],"mappings":";;;;AAmBO,IAAM,uBAAN,cAAmC,WAAW;CACnD,OAAO,KAAK;CACZ,OAAO,OAAO;CACd,OAAO,QAAQ;CACf,OAAO,UACL;CACF,OAAO,WAAW;EAAC;EAAgB;EAAsB;CAAc;CACvE,OAAO,QAAQ;EACb,IAAI;EACJ,OAAO;EACP,SAAS;CACX;CACA,OAAO,UAAU;EACf,IAAI;EACJ,OAAO;EACP,MAAM;EACN,aAAa;CACf;CACA,OAAO,SAAS,CAAC,YAAY,cAAc;CAG3C,OAAO,UAAU;CACjB,OAAO,WAAW,CAChB;EACE,MAAM;EACN,MAAM;EACN,QAAQ;EACR,OAAO;CACT,CACF;CACA,OAAO,MAAM,CACX;EACE,OAAO;EACP,OAAO;EACP,MAAM;EACN,aAAa;EACb,KAAK;EACL,MAAM;CACR,CACF;AACF;AAGO,IAAM,wBAAN,cAAoC,WAAW;CACpD,OAAO,KAAK;CACZ,OAAO,OAAO;CACd,OAAO,QAAQ;CACf,OAAO,UACL;CACF,OAAO,WAAW;EAAC;EAAiB;EAAmB;CAAgB;CACvE,OAAO,QAAQ;EACb,IAAI;EACJ,OAAO;EACP,SAAS;CACX;CACA,OAAO,UAAU;EACf,IAAI;EACJ,OAAO;EACP,MAAM;EACN,aAAa;CACf;CACA,OAAO,SAAS;EACd;EACA;EACA;EACA;EACA;CACF;CAGA,OAAO,UAAU;CACjB,OAAO,WAAW,CAChB;EACE,MAAM;EACN,MAAM;EACN,QAAQ;EACR,OAAO;CACT,CACF;CACA,OAAO,MAAM,CACX;EACE,OAAO;EACP,OAAO;EACP,MAAM;EACN,aAAa;EACb,KAAK;EACL,MAAM;CACR,CACF;AACF"}

package/dist/manifest.json

@@ -2,7 +2,7 @@
   "version": "1.0.0",
   "timestamp": 0,
   "packageName": "@happyvertical/smrt-ingestion",
-  "packageVersion": "0.55.8",
+  "packageVersion": "0.55.10",
   "objects": {
     "@happyvertical/smrt-ingestion:IntakeItem": {
       "name": "intakeitem",
@@ -4089,6 +4089,123 @@
     }
   },
   "moduleType": "smrt",
+  "recipes": [
+    {
+      "id": "ingestion.inbox",
+      "className": "IngestionInboxRecipe",
+      "label": "Ingestion inbox",
+      "summary": "Review incoming material and see which items need attention.",
+      "synonyms": [
+        "intake inbox",
+        "incoming documents",
+        "review queue"
+      ],
+      "models": [
+        "@happyvertical/smrt-ingestion:IntakeItem",
+        "@happyvertical/smrt-ingestion:IntakeEvidence"
+      ],
+      "nav": [
+        {
+          "label": "Ingestion inbox",
+          "model": "@happyvertical/smrt-ingestion:IntakeItem",
+          "icon": "archive",
+          "description": "Incoming material that needs authenticated attention.",
+          "key": "inbox",
+          "noun": "inbox item"
+        }
+      ],
+      "requires": [],
+      "group": {
+        "id": "ingestion",
+        "label": "Ingestion",
+        "summary": "Review incoming material safely before it can change records."
+      },
+      "section": {
+        "id": "ingestion",
+        "label": "Ingestion",
+        "icon": "archive",
+        "description": "Incoming material and its authenticated review workflow."
+      },
+      "help": {
+        "markdown": "## Overview\n\nThe ingestion inbox is where an authenticated reviewer finds incoming material\nthat needs attention. It keeps the original material and its related evidence\ntogether, so a reviewer can understand what arrived before choosing a next\nstep.\n\n## Tasks\n\n### Check items that need attention\n\n1. Open the ingestion inbox in an application that has configured an\n   authenticated review host.\n2. Choose an item to inspect its evidence and current review state.\n3. Open the item in Ingestion review when it has a proposed action.\n\n### Keep uncertain material for review\n\n1. Leave material in the inbox when there is not enough information to decide.\n2. Return after the application has new information or a reviewer can make a\n   decision.\n3. Do not treat an inbox item as permission to change another record.\n\n## Preview status\n\nThis recipe describes a preview workflow. The published evaluation did not meet\nquality gates and did not establish safety, so automation remains disabled. It\ndoes not configure a source, provider, generic record route, or automatic\naction. Applications continue to use the scoped callbacks described in the\ningestion review documentation.\n",
+        "fieldRefs": []
+      },
+      "surfaces": [
+        {
+          "kind": "route",
+          "path": "/ingestion/inbox",
+          "export": "@happyvertical/smrt-ingestion/svelte#IntakeInbox",
+          "label": "Ingestion inbox"
+        }
+      ],
+      "runtime": "both",
+      "demo": {
+        "mode": "server",
+        "reasons": [
+          "Needs a server because its package depends on @happyvertical/smrt-agents, @happyvertical/smrt-jobs, @happyvertical/smrt-profiles, @happyvertical/smrt-reports, @happyvertical/smrt-secrets, @happyvertical/smrt-tenancy, @happyvertical/smrt-users, which do not build for a browser (#3615, #3617, #3624, #3625, #3626, #3627)."
+        ]
+      }
+    },
+    {
+      "id": "ingestion.review",
+      "className": "IngestionReviewRecipe",
+      "label": "Ingestion review",
+      "summary": "Inspect evidence and approve, change, reject, or defer proposed actions.",
+      "synonyms": [
+        "intake review",
+        "proposal review",
+        "human approval"
+      ],
+      "models": [
+        "@happyvertical/smrt-ingestion:IntakeItem",
+        "@happyvertical/smrt-ingestion:IntakeEvidence",
+        "@happyvertical/smrt-ingestion:IntakeAnalysis",
+        "@happyvertical/smrt-ingestion:IntakeAction",
+        "@happyvertical/smrt-ingestion:IntakeReviewDecision"
+      ],
+      "nav": [
+        {
+          "label": "Ingestion review",
+          "model": "@happyvertical/smrt-ingestion:IntakeReviewDecision",
+          "icon": "fileText",
+          "description": "Revision-bound decisions on proposed actions.",
+          "key": "review",
+          "noun": "review decision"
+        }
+      ],
+      "requires": [],
+      "group": {
+        "id": "ingestion",
+        "label": "Ingestion",
+        "summary": "Review incoming material safely before it can change records."
+      },
+      "section": {
+        "id": "ingestion",
+        "label": "Ingestion",
+        "icon": "archive",
+        "description": "Incoming material and its authenticated review workflow."
+      },
+      "help": {
+        "markdown": "## Overview\n\nIngestion review lets an authorized person inspect the evidence behind a\nproposed action before it can affect another record. A decision is tied to the\nspecific material and proposal that the reviewer saw.\n\n## Tasks\n\n### Review a proposed action\n\n1. Open an inbox item that has a proposed action.\n2. Read the evidence and the proposed result in the authenticated review host.\n3. Approve, change, reject, or defer the proposal according to the current\n   application policy.\n\n### Return to an item after it changes\n\n1. Refresh the review when the host indicates that the material or proposal has\n   changed.\n2. Review the current proposal before making a decision.\n3. Leave a proposal deferred when its evidence or destination is still\n   uncertain.\n\n## Preview status\n\nThis recipe describes a preview workflow. The published evaluation did not meet\nquality gates and did not establish safety, so automation remains disabled. It\ndoes not create a generic editing surface or enable automatic execution. A host\nrechecks the reviewer, scope, and current proposal before it accepts a decision.\n",
+        "fieldRefs": []
+      },
+      "surfaces": [
+        {
+          "kind": "route",
+          "path": "/ingestion/review",
+          "export": "@happyvertical/smrt-ingestion/svelte#IntakeReview",
+          "label": "Ingestion review"
+        }
+      ],
+      "runtime": "both",
+      "demo": {
+        "mode": "server",
+        "reasons": [
+          "Needs a server because its package depends on @happyvertical/smrt-agents, @happyvertical/smrt-jobs, @happyvertical/smrt-profiles, @happyvertical/smrt-reports, @happyvertical/smrt-secrets, @happyvertical/smrt-tenancy, @happyvertical/smrt-users, which do not build for a browser (#3615, #3617, #3624, #3625, #3626, #3627)."
+        ]
+      }
+    }
+  ],
   "smrtDependencies": [
     "@happyvertical/smrt-agents",
     "@happyvertical/smrt-assets",