overlane 0.1.118 → 0.1.119

package/dist/overlane.mjs

@@ -22189,6 +22189,101 @@ var init_issues = __esm({
   }
 });
 
+// ../contracts/src/onboarding.ts
+function initialSteps() {
+  return STEP_NAMES.map((step2, i2) => ({ step: step2, status: i2 === 0 ? "done" : i2 === 1 ? "active" : "pending" }));
+}
+function newProgress(tenantId, userId, at) {
+  return { tenantId, userId, step: "agents", steps: initialSteps(), data: {}, version: 0, complete: false, updatedAt: at };
+}
+var STEP_NAMES, StepName, StepStatus, RepairAction, FAILURE_REPAIRS, FAILURE_CODES, FailureCodeSchema, StepState, Slug, RepoChoice, OnboardingData, OnboardingProgress, AdvanceRequest, AdvanceResponse, OnboardingEvent, FirstReview, onboardingPaths, PROGRESS_FIXTURE;
+var init_onboarding = __esm({
+  "../contracts/src/onboarding.ts"() {
+    "use strict";
+    init_zod();
+    init_common();
+    STEP_NAMES = ["sign-up", "agents", "repo", "first-task", "first-review", "invite"];
+    StepName = external_exports.enum(STEP_NAMES);
+    StepStatus = external_exports.enum(["pending", "active", "failed", "done"]);
+    RepairAction = external_exports.object({ id: external_exports.string().regex(/^[a-z][a-z0-9-]{1,48}$/), text: external_exports.string().min(1).max(300) }).strict();
+    FAILURE_REPAIRS = {
+      "sign-in-cancelled": { id: "retry-sign-in", text: "Sign-in was cancelled. Try again, or use the email link." },
+      "agent-not-connected": { id: "retry-connect", text: "The agent has not connected yet. Run the plugin command shown, then check again." },
+      "agent-oauth-denied": { id: "reauthorise", text: "Access was denied in the agent's own sign-in. Approve it there, then check again." },
+      "install-cancelled": { id: "retry-install", text: "The GitHub App install was cancelled. Retry the install, or use a native repository." },
+      "repo-unreachable": { id: "pick-another-repo", text: "That repository could not be read. Pick another, or re-run the install to grant access." },
+      "task-failed": { id: "retry-task", text: "The first task did not finish. Retry it, or pick a smaller template." },
+      "review-unavailable": { id: "reload-review", text: "The review is not ready. Reload it, or open the task to see its evidence." },
+      "invite-failed": { id: "retry-invite", text: "An invitation could not be sent. Check the address and try again, or skip this step." }
+    };
+    FAILURE_CODES = Object.keys(FAILURE_REPAIRS);
+    FailureCodeSchema = external_exports.enum(FAILURE_CODES);
+    StepState = external_exports.object({
+      step: StepName,
+      status: StepStatus,
+      failure: FailureCodeSchema.optional(),
+      repair: RepairAction.optional()
+    }).strict().refine((s) => s.status === "failed" === (s.repair !== void 0 && s.failure !== void 0), { message: "a failed step carries a failure code and a repair action, and no other step does" });
+    Slug = external_exports.string().regex(/^[a-z0-9][a-z0-9-]{0,39}$/);
+    RepoChoice = external_exports.object({
+      kind: external_exports.enum(["github", "native"]),
+      owner: external_exports.string().regex(/^[A-Za-z0-9-]{1,39}$/),
+      name: external_exports.string().regex(/^[A-Za-z0-9._-]{1,100}$/),
+      /** The GitHub App installation number; absent for a native repository. */
+      installationId: external_exports.number().int().positive().optional()
+    }).strict();
+    OnboardingData = external_exports.object({
+      agents: external_exports.array(Slug).max(20).optional(),
+      bots: external_exports.array(Slug).max(20).optional(),
+      repo: RepoChoice.optional(),
+      task: external_exports.object({ templateId: Slug, title: external_exports.string().min(1).max(200) }).strict().optional(),
+      invited: external_exports.number().int().min(0).max(100).optional()
+    }).strict();
+    OnboardingProgress = external_exports.object({
+      tenantId: TenantId,
+      userId: external_exports.string().min(1).max(100),
+      /** The current step: the first one not done, or the last when all are done. */
+      step: StepName,
+      steps: external_exports.array(StepState).length(STEP_NAMES.length),
+      data: OnboardingData,
+      /** Bumped by every transition; a client sends the one it read (optimistic concurrency). */
+      version: external_exports.number().int().min(0),
+      complete: external_exports.boolean(),
+      updatedAt: external_exports.string()
+    }).strict();
+    AdvanceRequest = external_exports.object({
+      step: StepName,
+      expectedVersion: external_exports.number().int().min(0),
+      outcome: external_exports.enum(["done", "failed"]),
+      failure: FailureCodeSchema.optional(),
+      data: OnboardingData.optional()
+    }).strict().refine((r) => r.outcome === "failed" === (r.failure !== void 0), { message: "failure is required with outcome failed, and only then" });
+    AdvanceResponse = external_exports.object({ applied: external_exports.boolean(), progress: OnboardingProgress }).strict();
+    OnboardingEvent = external_exports.object({
+      type: external_exports.enum(["onboarding.step_done", "onboarding.step_failed", "onboarding.resumed"]),
+      tenantId: TenantId,
+      userId: external_exports.string(),
+      step: StepName,
+      at: external_exports.string()
+    }).strict();
+    FirstReview = external_exports.object({
+      /** `fixture` until the review service (MS-A5) is live; the UI says so. */
+      source: external_exports.enum(["fixture", "live"]),
+      taskTitle: external_exports.string(),
+      verdict: external_exports.enum(["approve", "changes_requested"]),
+      summary: external_exports.string(),
+      findings: external_exports.array(external_exports.object({ severity: external_exports.enum(["blocker", "major", "minor", "nit"]), file: external_exports.string(), line: external_exports.number().int().positive(), message: external_exports.string() }).strict()),
+      evidence: external_exports.array(external_exports.object({ check: external_exports.string(), level: external_exports.string(), result: external_exports.enum(["pass", "fail"]) }).strict())
+    }).strict();
+    onboardingPaths = {
+      progress: (tenantId) => `/v1/tenants/${encodeURIComponent(tenantId)}/onboarding`,
+      advance: (tenantId) => `/v1/tenants/${encodeURIComponent(tenantId)}/onboarding/advance`,
+      firstReview: (tenantId) => `/v1/tenants/${encodeURIComponent(tenantId)}/onboarding/first-review`
+    };
+    PROGRESS_FIXTURE = newProgress("tm-fixture", "u-fixture", "2026-10-09T00:00:00.000Z");
+  }
+});
+
 // ../contracts/src/index.ts
 var init_src = __esm({
   "../contracts/src/index.ts"() {
@@ -22214,6 +22309,7 @@ var init_src = __esm({
     init_clients();
     init_memory();
     init_issues();
+    init_onboarding();
   }
 });
 
@@ -29566,7 +29662,7 @@ var VERSION;
 var init_assets = __esm({
   "src/assets.ts"() {
     "use strict";
-    VERSION = true ? "0.1.118" : "0.0.0-dev";
+    VERSION = true ? "0.1.119" : "0.0.0-dev";
   }
 });
 
@@ -54631,6 +54727,32 @@ async function probeService(deps, serviceUrl, token) {
 
 // ../cli/src/connect.ts
 var DEFAULT_SERVICE_URL = "https://api.overlane.dev";
+var CONNECT_STEPS = {
+  "sign-up": "sign in through the browser (OAuth with PKCE), or use HARNESS_TOKEN",
+  agents: "register the plugin with each agent's own commands (no vendor token is asked for)",
+  repo: "bind this GitHub project to the service",
+  "first-task": 'start your first task with `overlane task new "<title>"`',
+  "first-review": "read the first review in the web app",
+  invite: "invite teammates from the web app (optional, never blocks)"
+};
+async function reportStep(deps, serviceUrl, token, tenantId, step2, data) {
+  try {
+    const headers = { authorization: `Bearer ${token}`, accept: "application/json" };
+    const read = await deps.fetch(`${serviceUrl}${onboardingPaths.progress(tenantId)}`, { headers });
+    if (!read.ok) return null;
+    const progress = OnboardingProgress.parse(await read.json());
+    if (progress.step !== step2 || progress.complete) return progress.step;
+    const write = await deps.fetch(`${serviceUrl}${onboardingPaths.advance(tenantId)}`, {
+      method: "POST",
+      headers: { ...headers, "content-type": "application/json" },
+      body: JSON.stringify({ step: step2, expectedVersion: progress.version, outcome: "done", data })
+    });
+    if (!write.ok) return progress.step;
+    return OnboardingProgress.parse((await write.json()).progress).step;
+  } catch {
+    return null;
+  }
+}
 var MANIFESTS = {
   claude: join6(".claude-plugin", "marketplace.json"),
   codex: join6(".agents", "plugins", "marketplace.json")
@@ -54705,6 +54827,7 @@ async function connect(deps, options) {
   const bindingMissing = existing.kind !== "ok";
   const existingToken = await findToken(deps, serviceUrl);
   say(deps);
+  say(deps, `Steps (the same names as the web onboarding): ${STEP_NAMES.join(", ")}`);
   say(deps, "Plan");
   say(deps, `  sign-in: ${existingToken === null ? `browser sign-in to ${serviceUrl} (OAuth with PKCE), token kept in the OS keychain or a 0600 file in your user config directory` : `${describeStore(deps, existingToken.source)}`}`);
   say(deps, `  service: GET ${serviceUrl}/v1/me, then create or look up the project for ${repository.owner}/${repository.name}`);
@@ -54759,6 +54882,7 @@ async function connect(deps, options) {
     }
   }
   const token = await ensureToken(deps, serviceUrl);
+  say(deps, `[sign-up] ${CONNECT_STEPS["sign-up"]}: done`);
   say(deps, `Signed in; token source: ${describeStore(deps, token.source)}`);
   const wrote = [];
   const applied = [];
@@ -54793,6 +54917,8 @@ async function connect(deps, options) {
       entry.configLines = { text: codexEdit.block, createdFile: !codexEdit.fileExisted };
     }
     verify(deps, root, active);
+    say(deps, `[agents] ${CONNECT_STEPS.agents}: done`);
+    await reportStep(deps, serviceUrl, token.token, me.tenantId, "agents", { agents: active.map((info2) => info2.agent === "claude" ? "claude-code" : info2.agent) });
     if (writeIfDifferent(join6(root, BINDING_FILE), bindingText(binding))) {
       say(deps, `Wrote ${BINDING_FILE}`);
       wrote.push(BINDING_FILE);
@@ -54800,6 +54926,9 @@ async function connect(deps, options) {
     if (codexEdit !== null) wrote.push(CODEX_CONFIG_FILE);
     owned.binding = true;
     if (excludeNeeded && await addExclude(deps, root)) owned.excludeLine = true;
+    say(deps, `[repo] ${CONNECT_STEPS.repo}: done`);
+    const next = await reportStep(deps, serviceUrl, token.token, me.tenantId, "repo", { repo: { kind: "github", owner: repository.owner, name: repository.name } });
+    if (next !== null) say(deps, `Next in onboarding: ${next === "repo" ? "first-task" : next} (${CONNECT_STEPS[next === "repo" ? "first-task" : next]})`);
   } finally {
     if (previousOwned !== null || owned.binding || owned.claude !== void 0 || owned.codex !== void 0) writeOwned(root, owned);
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "overlane",
-  "version": "0.1.118",
+  "version": "0.1.119",
   "description": "Overlane: connect a GitHub project to your coding agents. One portable CLI with project memory, tasks, a code index, guardrails and the Claude Code and Codex plugin.",
   "keywords": [
     "overlane",

package/plugins/claude/plugins/mvrx-harness/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "mvrx-harness",
-  "version": "0.1.118",
+  "version": "0.1.119",
   "description": "Harness context at session start and the shared harness skills.",
   "author": {
     "name": "owenob1"