@mrrlin-dev/mcp 0.4.114 → 0.4.116

package/dist/bin.cjs

@@ -38515,6 +38515,43 @@ var mrrlinDeclaredOutcomeSchema = mrrlinDeclaredOutcomeShapeSchema.superRefine((
     });
   }
 });
+var MRRLIN_PROJECT_CODE_HOSTS = ["github", "gitlab", "local"];
+var mrrlinProjectCodeHostSchema = external_exports.enum(MRRLIN_PROJECT_CODE_HOSTS);
+var GIT_SHA_PATTERN = /^(?:[0-9a-f]{40}|[0-9a-f]{64})$/;
+var SHA256_HEX_PATTERN = /^[0-9a-f]{64}$/;
+var MRRLIN_LOCAL_DELIVERY_REF_PATTERN = /^git\+local:\/\/([^/\s@]+)\/(mrrlin\/run-ER-[A-Za-z0-9-]+)@([0-9a-f]{40}|[0-9a-f]{64})$/;
+var mrrlinLocalDeliveryRefSchema = external_exports.string().regex(MRRLIN_LOCAL_DELIVERY_REF_PATTERN, "deliveryRef must be git+local://<projectSlug>/mrrlin/run-<runId>@<sha>");
+var mrrlinLocalBuildStepSchema = external_exports.object({
+  command: external_exports.string().trim().min(1).max(200),
+  exitCode: external_exports.number().int(),
+  logDigest: external_exports.string().regex(SHA256_HEX_PATTERN)
+});
+var mrrlinLocalBuildEvidenceSchema = external_exports.object({
+  branch: external_exports.string().regex(/^mrrlin\/run-ER-[A-Za-z0-9-]+$/),
+  baseSha: external_exports.string().regex(GIT_SHA_PATTERN),
+  headSha: external_exports.string().regex(GIT_SHA_PATTERN),
+  commitCount: external_exports.number().int(),
+  steps: external_exports.array(mrrlinLocalBuildStepSchema).max(4),
+  noBuildStep: external_exports.boolean(),
+  checkoutDigest: external_exports.string().regex(SHA256_HEX_PATTERN)
+});
+function checkLocalBuildEvidence(evidence, local) {
+  if (evidence.type !== "build")
+    return `localBuild evidence requires evidence.type "build", got "${evidence.type}"`;
+  if (evidence.value !== local.headSha)
+    return "evidence.value must equal localBuild.headSha";
+  if (local.commitCount <= 0)
+    return "localBuild.commitCount must be > 0: a run with no commits never closes a task";
+  if (local.headSha === local.baseSha)
+    return "localBuild.headSha equals baseSha: nothing was committed";
+  if (local.noBuildStep !== (local.steps.length === 0)) {
+    return "localBuild.noBuildStep must be true exactly when no build/test command was detected";
+  }
+  const failed = local.steps.find((step) => step.exitCode !== 0);
+  if (failed)
+    return `localBuild step "${failed.command}" exited ${failed.exitCode}`;
+  return null;
+}
 var mrrlinReceiptSchema = external_exports.object({
   kind: external_exports.enum(["outcome", "attempt"]),
   evidence: external_exports.object({
@@ -38522,7 +38559,17 @@ var mrrlinReceiptSchema = external_exports.object({
     value: external_exports.string().trim().min(1)
   }),
   observedAt: external_exports.string().datetime(),
-  requiresCovered: external_exports.array(artifactKindSchema)
+  requiresCovered: external_exports.array(artifactKindSchema),
+  // local-git-delivery: what the BRIDGE observed for a code_change delivered into a local git repo.
+  // Optional, so every existing receipt is untouched; when present it is checked by
+  // checkLocalBuildEvidence below, which is the single receipt rule of the design.
+  localBuild: mrrlinLocalBuildEvidenceSchema.optional()
+}).superRefine((value, ctx) => {
+  if (!value.localBuild)
+    return;
+  const problem = checkLocalBuildEvidence(value.evidence, value.localBuild);
+  if (problem)
+    ctx.addIssue({ code: external_exports.ZodIssueCode.custom, path: ["localBuild"], message: problem });
 });
 function buildReceipt(input) {
   return {
@@ -38982,7 +39029,10 @@ var mrrlinProjectSummarySchema = external_exports.object({
   // workspace-context-isolation (OQ-091): explicit client name and scope description
   // for multi-tenant workspace containment. Output-optional and nullable for backwards compatibility.
   clientName: external_exports.string().trim().max(80).nullable().optional(),
-  scopeDescription: external_exports.string().trim().max(240).nullable().optional()
+  scopeDescription: external_exports.string().trim().max(240).nullable().optional(),
+  // local-git-delivery: where this project's code lives. Null means "not asked yet" -- see
+  // mrrlinProjectCodeHostSchema. Output-optional so existing fixtures need no churn.
+  codeHost: mrrlinProjectCodeHostSchema.nullable().optional()
 });
 var mrrlinProjectOperatorInputSchema = external_exports.string().regex(/^@[!-~]+$/, "operator must be '@' followed by printable ASCII with no whitespace");
 var mrrlinProjectUpsertSchema = mrrlinProjectSummarySchema.omit({
@@ -38995,7 +39045,8 @@ var mrrlinProjectRenameSchema = external_exports.object({
   displayName: external_exports.string().trim().min(1).max(120).optional(),
   intentJudgeEnabled: external_exports.boolean().optional(),
   clientName: external_exports.string().trim().max(80).nullable().optional(),
-  scopeDescription: external_exports.string().trim().max(240).nullable().optional()
+  scopeDescription: external_exports.string().trim().max(240).nullable().optional(),
+  codeHost: mrrlinProjectCodeHostSchema.nullable().optional()
 });
 var ONBOARDING_KICKOFF_TRANSITIONS = [
   { from: null, to: "pending" },
@@ -39032,7 +39083,8 @@ var mrrlinProjectSnapshotSchema = external_exports.object({
     emoji: mrrlinProjectEmojiSchema,
     slug: mrrlinProjectSlugSchema,
     clientName: external_exports.string().trim().max(80).nullable().optional(),
-    scopeDescription: external_exports.string().trim().max(240).nullable().optional()
+    scopeDescription: external_exports.string().trim().max(240).nullable().optional(),
+    codeHost: mrrlinProjectCodeHostSchema.nullable().optional()
   }),
   taskDependencies: external_exports.array(mrrlinTaskDependencySchema).default([]),
   taskEvents: external_exports.array(mrrlinTaskEventSchema).default([]),
@@ -39552,6 +39604,9 @@ var mrrlinExecutionRunSchema = external_exports.object({
   projectSlug: mrrlinProjectSlugSchema,
   provider: external_exports.string().min(1),
   pullRequestUrl: external_exports.string().min(1).nullable(),
+  // local-git-delivery: set instead of pullRequestUrl when a run delivered into a local git repo.
+  // Optional + nullable: absent on every pre-existing run and on every GitHub run.
+  deliveryRef: mrrlinLocalDeliveryRefSchema.nullable().optional(),
   startedAt: external_exports.string().datetime().nullable(),
   status: mrrlinExecutionRunStatusSchema,
   taskId: mrrlinTaskIdSchema,
@@ -39646,6 +39701,7 @@ var mrrlinExecutionRunUpdateSchema = external_exports.object({
   prodPublishRef: external_exports.string().min(1).nullable().optional(),
   prodWorkflowId: external_exports.number().int().positive().nullable().optional(),
   pullRequestUrl: external_exports.string().min(1).nullable().optional(),
+  deliveryRef: mrrlinLocalDeliveryRefSchema.nullable().optional(),
   status: mrrlinExecutionRunStatusSchema.optional(),
   worktreeId: external_exports.string().min(1).nullable().optional(),
   // Slice 6 (cost telemetry) + Slice 7 (effort). All nullable and optional: per D6, NULL means
@@ -58732,7 +58788,7 @@ var mcpToolDescriptions = {
   [mcpToolNames.searchWikiPages]: "Search project Wiki pages using ranked full-text search. Returns excerpts suitable for grounding Director decisions.",
   [mcpToolNames.searchKnowledge]: "Search the rendered Mrrlin docs wiki using the lexical RAG index. Returns cited chunks with stable wiki_url fields.",
   [mcpToolNames.updatePlan]: "Update a plan/epic.",
-  [mcpToolNames.updateTask]: `Update a task. Honors DB invariants: closed_no_result requires linked Evidence wiki pages. Set directorThreadId here to persist the worker's resumable provider thread handle. specApproved: "approved" requires declaredOutcome (set it in the same call or earlier): an object {sentence, requires, verification} stating what must exist when the task is done.`,
+  [mcpToolNames.updateTask]: `Update a task. Honors DB invariants: closed_no_result requires linked Evidence wiki pages. Set directorThreadId here to persist the worker's resumable provider thread handle. specApproved: "approved" requires declaredOutcome (set it in the same call or earlier): an object {sentence, requires, verification} stating what must exist when the task is done. The Director sets it itself when writing the spec. requires holds one kind; verification is "machine" for page, code_change or message, "human_tap" for document, file_set or structured_data.`,
   [mcpToolNames.resetDirectorThread]: "Clear a task's persisted Director execution thread handle so the next execution run starts a fresh provider thread. Records a director_thread_reset task event.",
   [mcpToolNames.archiveTask]: "Archive a task: hides it from default reads, removes it from plan progress and scheduler consideration, cancels its non-terminal execution runs, and closes its open inbox items. Reversible \u2014 the project owner can restore it with unarchive_task. Records an 'archived' task event.",
   [mcpToolNames.unarchiveTask]: "Restore an archived task to its original status and visibility. Owner-only \u2014 refused with NOT_PROJECT_OWNER for any other caller. Does not resurrect the execution runs or inbox items that were cancelled/closed when the task was archived. Records a 'restored' task event.",
@@ -61764,7 +61820,7 @@ Do NOT derail the current task - if the operator has an in-flight question, answ
 }
 
 // src/_generated/version.ts
-var PKG_VERSION = "0.4.114";
+var PKG_VERSION = "0.4.116";
 
 // src/receipt-signing.ts
 var import_node_crypto13 = __toESM(require("node:crypto"), 1);
@@ -74560,6 +74616,7 @@ function buildThreadStartParams(msg, config2, desiredModel) {
     "- MUST include `## Verification`: the exact tests, commands, or checks that prove each criterion holds.",
     "- Keep behavior contracts in the spec; implementation details belong in `## Implementation Plan`.",
     "- Apply this format ONLY to Specs/{id} pages; do not retro-fit it onto other wiki page types.",
+    "- With each spec, set the task's `declaredOutcome` via `update_task` yourself; approval needs it.",
     '- Spec consensus runs ASYNCHRONOUSLY. Call `run_spec_consensus` for a `Specs/{id}` page; it returns IMMEDIATELY. On `already_converged`, the spec is already marked ready \u2014 proceed straight to `create_execution_run`; do NOT call `mark_spec_ready` and do NOT re-run consensus. On `queued` or `already_running`, tell the user it was launched and END your turn \u2014 do NOT poll or call it again; the result arrives in the inbox (an `info` item on CONVERGED, a `handoff` item if it was blocked/failed). When a `handoff` says it was blocked, address the recorded issues in the spec (any edit re-arms the gate) and call `run_spec_consensus` once more. For a NON-code task (domain seo/marketing/content, ADR 0020): the low-risk lanes `seo`, `marketing`, and `content` proceed to `create_execution_run` after consensus converges, using the same flow as code tasks. When the review agrees, tell the operator "the reviewers agreed on the spec" and proceed to create_execution_run. When it does not, tell them the reviewers could not agree and that there is a decision question in the inbox. Never say "consensus", "converged", or "CONVERGED" to the operator; those are internal words.',
     "- When creating a task, classify and supply the `domain` field explicitly based on the nature of the work: pass `domain:'code'` for software engineering work, `domain:'seo'` for SEO/optimization, `domain:'marketing'` for marketing/growth, or `domain:'content'` for content creation/writing \u2014 the same way you select category/subcategory. A follow-up task spawned with `parentTaskId` inherits its parent's domain automatically and requires no explicit domain.",
     '- When a task needs a browser (login flows, UI verification/clicks, scraping), pass `prerequisites:[{mcp:"mrrlin-browser",reason:"..."}]` to `create_execution_run`. If that run later fails into a handoff, the operator gets a one-click "Launch browser & resume" that brings up the dedicated browser as the turn starts.',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mrrlin-dev/mcp",
-  "version": "0.4.114",
+  "version": "0.4.116",
   "type": "module",
   "bin": {
     "mrrlin-mcp": "dist/bin.cjs"