@brainervirus/workit-pi 8.14.0 → 8.15.0

package/dist/worker.js

@@ -7546,6 +7546,8 @@ var text = string2().check((ctx) => {
     ctx.issues.push({ code: "custom", input: ctx.value, message: "invalid Unicode", path: [] });
 });
 var id = text.regex(uuidPattern, "expected lowercase UUID");
+var idRefPattern = /^[0-9a-f][0-9a-f-]{7,35}$/;
+var idRef = text.regex(idRefPattern, "expected a UUID or an id prefix of 8+ characters");
 var digest = text.regex(digestPattern, "expected lowercase SHA-256 digest");
 var revision = text.regex(uuidPattern, "expected UUID revision");
 var validUtc = (value) => {
@@ -7825,7 +7827,7 @@ var workerReportSchema = object({
   outcome: _enum(["completed", "failed", "cancelled"]),
   summary: text,
   evidenceIds: array(id),
-  findingIds: array(id)
+  findingIds: array(idRef)
 }).strict();
 var workerSchema = object({
   assignment: assignmentSchema,
@@ -8018,7 +8020,7 @@ var findingOperations = {
     action: literal("resolve"),
     ...taskId,
     expectedRevision: revision.optional(),
-    findingId: id,
+    findingId: idRef,
     disposition: _enum(["open", "fixed", "dismissed", "deferred"]),
     reason: text,
     evidenceIds: array(id),
@@ -8059,7 +8061,7 @@ var workerOperations = {
     ...taskId,
     expectedRevision: revision.optional(),
     expectedWorkspaceRevision: revision.optional(),
-    workerId: id,
+    workerId: idRef,
     report: workerReportSchema
   }),
   cancel: operation({
@@ -8067,7 +8069,7 @@ var workerOperations = {
     ...taskId,
     ...revisions,
     expectedWorkspaceRevision: revision.optional(),
-    workerId: id,
+    workerId: idRef,
     reason: text
   })
 };
@@ -8544,20 +8546,19 @@ var workspaceConfigSchema = object({
     union([boolean2(), literal("verified")]).optional()
   ]))).passthrough().optional(),
   youtrack: object({ baseUrl: nonBlank.optional(), link_issues: boolean2().optional() }).passthrough().optional(),
-  issues: object({ provider: literal("github").optional(), link_on_pr: boolean2().optional() }).passthrough().optional(),
+  issues: object({
+    provider: _enum(["github", "gitlab", "youtrack"]).optional(),
+    link: boolean2().optional(),
+    relation: unknown().optional(),
+    backlink: boolean2().optional(),
+    link_on_pr: boolean2().optional()
+  }).passthrough().optional(),
   branchPolicy: workspaceBranchPolicySchema.optional(),
   commitPolicy: workspaceCommitPolicySchema.optional(),
   defaultProfile: nonBlank.optional(),
   profiles: record(nonBlank, workspaceProfileSchema).optional(),
   releaseTracks: record(nonBlank, releaseTrackSchema).optional()
 }).passthrough().superRefine((workspace, context) => {
-  if (workspace.issues && workspace.vcs?.provider !== "github") {
-    context.addIssue({
-      code: "custom",
-      path: ["issues"],
-      message: `GitHub issue linking requires the github provider, got ${workspace.vcs?.provider ?? "unset"}`
-    });
-  }
   if (workspace.defaultProfile !== undefined && !Object.hasOwn(workspace.profiles ?? {}, workspace.defaultProfile)) {
     context.addIssue({
       code: "custom",
@@ -8611,11 +8612,19 @@ var KNOWN_FIELDS = new Set([
 ]);
 var memo2 = new Map;
 
+// packages/workit-core/src/core/vcs-config.ts
+var TRACKERS = new Set(["github", "gitlab", "youtrack"]);
+
 // packages/workit-core/src/ledger.ts
 var PASSING = new Set(["verified", "tests-verified", "type-check-only"]);
 var FAILING = new Set(["failed", "blocked"]);
 var STRONG_RESULTS = new Set(["verified", "tests-verified"]);
-var PR_ROW_TYPES = new Set(["pr.created", "pr.status", "pr.merged"]);
+var PR_ROW_TYPES = new Set([
+  "pr.created",
+  "pr.status",
+  "pr.merged",
+  "pr.linked"
+]);
 var NETWORK_FS_TYPES = new Set([
   26985,
   20859,

package/dist/workit.js

@@ -7771,6 +7771,8 @@ var text = string2().check((ctx) => {
     ctx.issues.push({ code: "custom", input: ctx.value, message: "invalid Unicode", path: [] });
 });
 var id = text.regex(uuidPattern, "expected lowercase UUID");
+var idRefPattern = /^[0-9a-f][0-9a-f-]{7,35}$/;
+var idRef = text.regex(idRefPattern, "expected a UUID or an id prefix of 8+ characters");
 var digest = text.regex(digestPattern, "expected lowercase SHA-256 digest");
 var revision = text.regex(uuidPattern, "expected UUID revision");
 var validUtc = (value) => {
@@ -8148,7 +8150,7 @@ var workerReportSchema = object({
   outcome: _enum(["completed", "failed", "cancelled"]),
   summary: text,
   evidenceIds: array(id),
-  findingIds: array(id)
+  findingIds: array(idRef)
 }).strict();
 var workerSchema = object({
   assignment: assignmentSchema,
@@ -8394,7 +8396,7 @@ var findingOperations = {
     action: literal("resolve"),
     ...taskId,
     expectedRevision: revision.optional(),
-    findingId: id,
+    findingId: idRef,
     disposition: _enum(["open", "fixed", "dismissed", "deferred"]),
     reason: text,
     evidenceIds: array(id),
@@ -8435,7 +8437,7 @@ var workerOperations = {
     ...taskId,
     expectedRevision: revision.optional(),
     expectedWorkspaceRevision: revision.optional(),
-    workerId: id,
+    workerId: idRef,
     report: workerReportSchema
   }),
   cancel: operation({
@@ -8443,7 +8445,7 @@ var workerOperations = {
     ...taskId,
     ...revisions,
     expectedWorkspaceRevision: revision.optional(),
-    workerId: id,
+    workerId: idRef,
     reason: text
   })
 };
@@ -8493,6 +8495,16 @@ var success = (revisionValue, workspaceRevisionValue, data) => ({
   data
 });
 var failure2 = (code, error, details = {}) => ({ ok: false, schemaVersion: 1, code, error, details });
+function resolveIdRef(kind, ref, ids) {
+  if (ids.includes(ref))
+    return success(null, null, ref);
+  const matches = ids.filter((candidate) => candidate.startsWith(ref));
+  if (matches.length === 1)
+    return success(null, null, matches[0]);
+  if (matches.length === 0)
+    return failure2("not_found", `${kind} not found`);
+  return failure2("invalid_input", `${kind} prefix ${ref} is ambiguous; candidates: ${matches.join(", ")}`);
+}
 function parseOperation(family, input) {
   if (typeof input === "object" && input !== null && "schemaVersion" in input && input.schemaVersion !== SCHEMA_VERSION)
     return failure2("unsupported_version", "unsupported schema version", { operation: family });
@@ -10022,7 +10034,7 @@ var removeIfEmpty = (dir) => {
 };
 var tokenHash = (token) => createHash3("sha256").update(token).digest("hex");
 function recordIssuedSession(cwd, lead, issued) {
-  const token = randomBytes2(18).toString("base64url");
+  const token = randomBytes2(18).toString("hex");
   try {
     migrateRepoIssued(cwd);
     const own = hash(issued);
@@ -11036,20 +11048,26 @@ class TaskStore {
     return success(null, null, { key: key.data, bound: bound.data });
   }
   taskForWorker(workerId) {
-    if (typeof workerId !== "string" || !validId(workerId))
+    if (typeof workerId !== "string" || !idRefPattern.test(workerId))
       return failure2("invalid_input", "needs a worker id: `workit worker cancel|report <workerId>`");
     const listed = this.listTaskIndex();
     if (!listed.ok)
       return listed;
+    const owners = new Map;
     for (const entry of listed.data) {
       if (entry.status === "closed")
         continue;
       const loaded = this.load(entry.id);
       if (!loaded.ok)
         return loaded;
-      if (loaded.data?.record.workers.some((worker) => worker.id === workerId))
-        return success(null, null, entry.id);
+      for (const worker of loaded.data?.record.workers ?? [])
+        owners.set(worker.id, entry.id);
     }
+    const resolved = resolveIdRef("worker", workerId, [...owners.keys()]);
+    if (resolved.ok)
+      return success(null, null, owners.get(resolved.data) ?? null);
+    if (resolved.code !== "not_found")
+      return resolved;
     return success(null, null, null);
   }
   originTaskEntry() {
@@ -13174,20 +13192,19 @@ var workspaceConfigSchema = object({
     union([boolean2(), literal("verified")]).optional()
   ]))).passthrough().optional(),
   youtrack: object({ baseUrl: nonBlank.optional(), link_issues: boolean2().optional() }).passthrough().optional(),
-  issues: object({ provider: literal("github").optional(), link_on_pr: boolean2().optional() }).passthrough().optional(),
+  issues: object({
+    provider: _enum(["github", "gitlab", "youtrack"]).optional(),
+    link: boolean2().optional(),
+    relation: unknown().optional(),
+    backlink: boolean2().optional(),
+    link_on_pr: boolean2().optional()
+  }).passthrough().optional(),
   branchPolicy: workspaceBranchPolicySchema.optional(),
   commitPolicy: workspaceCommitPolicySchema.optional(),
   defaultProfile: nonBlank.optional(),
   profiles: record(nonBlank, workspaceProfileSchema).optional(),
   releaseTracks: record(nonBlank, releaseTrackSchema).optional()
 }).passthrough().superRefine((workspace, context) => {
-  if (workspace.issues && workspace.vcs?.provider !== "github") {
-    context.addIssue({
-      code: "custom",
-      path: ["issues"],
-      message: `GitHub issue linking requires the github provider, got ${workspace.vcs?.provider ?? "unset"}`
-    });
-  }
   if (workspace.defaultProfile !== undefined && !Object.hasOwn(workspace.profiles ?? {}, workspace.defaultProfile)) {
     context.addIssue({
       code: "custom",
@@ -14062,6 +14079,44 @@ var readVcsConfig = () => {
   }
   return { status: "malformed", path: file, config: {}, error: `${file} is not a JSON object` };
 };
+var TRACKERS = new Set(["github", "gitlab", "youtrack"]);
+var asRecord = (value) => value && typeof value === "object" && !Array.isArray(value) ? value : {};
+var flag = (value) => typeof value === "boolean" ? value : null;
+var text2 = (value) => typeof value === "string" && value.trim() ? value.trim() : null;
+function issueTrackerOf(issues, youtrack) {
+  const iss = asRecord(issues);
+  const yt = asRecord(youtrack);
+  const warnings = [];
+  const named = typeof iss.provider === "string" && TRACKERS.has(iss.provider.toLowerCase()) ? iss.provider.toLowerCase() : null;
+  if (iss.relation !== undefined && iss.relation !== "closes" && iss.relation !== "refs")
+    warnings.push(`issues.relation ${JSON.stringify(iss.relation)} is not closes or refs; read as closes`);
+  for (const key of ["repo", "host"])
+    if (iss[key] !== undefined && text2(iss[key]) === null)
+      warnings.push(`issues.${key} is not a non-empty string; ignored`);
+  const common = {
+    relation: iss.relation === "refs" ? "refs" : "closes",
+    backlink: iss.backlink === true,
+    baseUrl: text2(yt.baseUrl),
+    repo: text2(iss.repo)?.replace(/^\/+|\/+$/gu, "") ?? null,
+    host: text2(iss.host)?.toLowerCase() ?? null,
+    warnings
+  };
+  const legacyGithub = named === "github" && flag(iss.link) === null;
+  if (flag(yt.link_issues) === true && (named === null || legacyGithub))
+    return { provider: "youtrack", link: true, ...common, source: "youtrack.link_issues" };
+  if (named) {
+    const link = flag(iss.link) ?? flag(iss.link_on_pr) ?? (named === "youtrack" ? flag(yt.link_issues) : null) ?? false;
+    return {
+      provider: named,
+      link,
+      ...common,
+      source: flag(iss.link) === null && flag(iss.link_on_pr) !== null ? "issues.link_on_pr" : "issues"
+    };
+  }
+  if (common.baseUrl)
+    return { provider: "youtrack", link: false, ...common, source: "youtrack.baseUrl" };
+  return null;
+}
 var trackSummary = (resolution) => resolution.status === "resolved" ? {
   name: resolution.track?.name ?? null,
   source: resolution.source,
@@ -14082,6 +14137,7 @@ function vcsConfig(mode, cwd, options = {}) {
   const rawProvider = wsVcs.provider ?? (determinateRoot ? remoteProvider(root) : null) ?? cfg.provider ?? null;
   const provider = rawProvider === null || rawProvider === undefined ? null : String(rawProvider).toLowerCase() || null;
   const workspaceDefault = workspaceDefaultTarget(root, cfg.defaultTargetBranch);
+  const issueTracker = issueTrackerOf(wsIssues, wsYt);
   const linkIssues = typeof wsYt.link_issues === "boolean" ? wsYt.link_issues : null;
   const youtrackBaseUrl = typeof wsYt.baseUrl === "string" ? wsYt.baseUrl : null;
   let issuesProvider = null;
@@ -14114,7 +14170,8 @@ function vcsConfig(mode, cwd, options = {}) {
       link_issues: linkIssues,
       youtrack_base_url: youtrackBaseUrl,
       issues_provider: issuesProvider,
-      link_on_pr: linkOnPr
+      link_on_pr: linkOnPr,
+      issue_tracker: issueTracker
     };
   }
   if (cfgStatus === "malformed") {
@@ -14140,7 +14197,8 @@ function vcsConfig(mode, cwd, options = {}) {
     link_issues: linkIssues,
     youtrack_base_url: youtrackBaseUrl,
     issues_provider: issuesProvider,
-    link_on_pr: linkOnPr
+    link_on_pr: linkOnPr,
+    issue_tracker: issueTracker
   };
   if (provider === "gitlab") {
     out.gitlab = {
@@ -14244,7 +14302,12 @@ var MAX_LINE_BYTES = 4096;
 var PASSING = new Set(["verified", "tests-verified", "type-check-only"]);
 var FAILING = new Set(["failed", "blocked"]);
 var STRONG_RESULTS = new Set(["verified", "tests-verified"]);
-var PR_ROW_TYPES = new Set(["pr.created", "pr.status", "pr.merged"]);
+var PR_ROW_TYPES = new Set([
+  "pr.created",
+  "pr.status",
+  "pr.merged",
+  "pr.linked"
+]);
 var err = (code, error, unblock) => ({
   ok: false,
   code,
@@ -18572,7 +18635,7 @@ var RISK = {
 };
 var YES = new Set(["true", "yes", "y", "1", "on"]);
 var NO = new Set(["false", "no", "n", "0", "off", "none"]);
-var flag = (value, unknownAs) => {
+var flag2 = (value, unknownAs) => {
   if (typeof value === "boolean")
     return { ok: true, value };
   if (typeof value === "number" && (value === 0 || value === 1))
@@ -18638,12 +18701,12 @@ function normalizeJudgment(raw, previous) {
       const items = Array.isArray(value) ? value : [value];
       judgment.refs.push(...items.filter((item) => item !== null && item !== "").map(refOf));
     } else {
-      if (name === "needsPlan" && typeof value === "string" && !flag(value, false).ok && value.trim()) {
+      if (name === "needsPlan" && typeof value === "string" && !flag2(value, false).ok && value.trim()) {
         judgment.needsPlan = true;
         judgment.refs.push(refOf(value.trim()));
         continue;
       }
-      const parsed = flag(value, name === "behaviorChange");
+      const parsed = flag2(value, name === "behaviorChange");
       if (parsed.ok)
         judgment[name] = parsed.value;
       else
@@ -18998,6 +19061,8 @@ var TASK_SCOPED_ACTIONS = new Set([
   "worker.cancel",
   "state.export"
 ]);
+var ONLY_OWN_REPORT = "workers can submit only their own report";
+var NO_HELPER_CONTROL = "helpers cannot cancel or control workers";
 var WORKER_ADDRESSED_ACTIONS = new Set(["worker.cancel", "worker.report"]);
 var workerCommand = (taskId, request) => {
   const { action, workerId, reason, report } = request;
@@ -19895,6 +19960,10 @@ class WorkitCore {
     }
     if (helper?.ok)
       return failure2("permission_denied", "helpers cannot resolve findings");
+    const findingRef = resolveIdRef("finding", input.findingId, task.data.findings.map((entry) => entry.id));
+    if (!findingRef.ok)
+      return findingRef;
+    input.findingId = findingRef.data;
     const finding = task.data.findings.find((entry) => entry.id === input.findingId);
     if (!finding)
       return failure2("not_found", "finding not found");
@@ -20046,15 +20115,31 @@ class WorkitCore {
         return changed;
       return success(changed.data.task.revision, changed.data.workspace.revision, changed.data.task.workers.at(-1));
     }
+    const workerRef = resolveIdRef("worker", input.workerId, helperId === null ? task.data.workers.map((candidate) => candidate.id) : [helperId]);
+    if (!workerRef.ok)
+      return helperId === null ? workerRef : failure2("permission_denied", input.action === "report" ? ONLY_OWN_REPORT : NO_HELPER_CONTROL);
+    input.workerId = workerRef.data;
     const entry = task.data.workers.find((candidate) => candidate.id === input.workerId);
     if (!entry)
       return failure2("not_found", "worker not found");
     if (input.action === "report") {
       if (helperId === null || helperId !== input.workerId)
-        return failure2("permission_denied", "workers can submit only their own report");
+        return failure2("permission_denied", ONLY_OWN_REPORT);
       const helper = this.helperEntry(task.data, true, true);
       if (!helper.ok)
         return helper;
+      const ownFindings = task.data.findings.filter((candidate) => candidate.provenance.workerId === helperId).map((candidate) => candidate.id);
+      const reported = [];
+      for (const findingRef of input.report.findingIds) {
+        const found = resolveIdRef("finding", findingRef, ownFindings);
+        if (found.ok)
+          reported.push(found.data);
+        else if (found.code === "not_found")
+          reported.push(findingRef);
+        else
+          return found;
+      }
+      input.report.findingIds = reported;
       const evidence = task.data.evidence.filter((candidate) => input.report.evidenceIds.includes(candidate.id));
       const findings = task.data.findings.filter((candidate) => input.report.findingIds.includes(candidate.id));
       if (evidence.length !== input.report.evidenceIds.length || findings.length !== input.report.findingIds.length)
@@ -20082,7 +20167,7 @@ class WorkitCore {
       return updated ? success(changed.data.task.revision, changed.data.workspace.revision, updated) : failure2("recovery_required", "worker disappeared during report");
     }
     if (helperId !== null)
-      return failure2("permission_denied", "helpers cannot cancel or control workers");
+      return failure2("permission_denied", NO_HELPER_CONTROL);
     if (task.data.status === "closed")
       return failure2("invalid_transition", "closed task cannot cancel workers");
     if (entry.data.state === "stopped") {
@@ -23779,7 +23864,10 @@ var readAssignment = (ctx, request) => {
     return failure2("permission_denied", "worker assignment is not bound to this workspace");
   if (task.data.status !== "active")
     return failure2("invalid_transition", "paused or closed tasks cannot supervise workers");
-  const worker = task.data.workers.find((candidate) => candidate.id === request.workerId);
+  const workerId = resolveIdRef("worker", request.workerId, task.data.workers.map((candidate) => candidate.id));
+  if (!workerId.ok)
+    return workerId;
+  const worker = task.data.workers.find((candidate) => candidate.id === workerId.data);
   if (!worker)
     return failure2("not_found", "worker assignment not found");
   return success(null, workspace.data.revision, {
@@ -23926,7 +24014,7 @@ function extension(pi) {
     if (!validated.ok)
       return validated;
     const { store, task, workspace, worker } = validated.data;
-    const current = [...workers.values()].find((handle) => handle.workerId === request.workerId);
+    const current = [...workers.values()].find((handle) => handle.workerId === worker.id);
     if (request.action === "cancel") {
       if (!current)
         return failure2("recovery_required", "worker process is not live in this session");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@brainervirus/workit-pi",
-  "version": "8.14.0",
+  "version": "8.15.0",
   "description": "Workit native extension for Pi — tools, method skills, and session continuity",
   "keywords": [
     "agentic-coding",

package/skills/workit-ship/SKILL.md

@@ -33,8 +33,8 @@ that repeats because the base keeps moving, or after 3 failed fix attempts on
 the same check.
 
 1. **Open.** `workit git push`, then `workit pr create --title "<title>"
-   --body-file <f|->` (idempotent; body: `references/pr-body.md`; edits:
-   `workit pr edit`). A stack: `workit stack plan <bottom> ... <top>`, one
+   --body-file <f|->` plus `--issue <#n|ID>` per issue (`--refs`: no close; idempotent;
+   body: `references/pr-body.md`; edits: `workit pr edit`). A stack: `workit stack plan <bottom> ... <top>`, one
    `workit pr create --base <parent> --fill` per branch, then
    `workit stack sync`. Finish the whole stack before babysitting any PR.
 2. **Read state** with `workit pr status --json`. `REVIEW` alone is a pending