@onetaskgraph/sdk 0.12.11 → 0.12.13

package/dist/client.d.ts

@@ -1,4 +1,4 @@
-import type { CacheCleared, Classification, CommentList, CommentWritten, CopyReport, DeletedComment, DocumentDetail, EffectiveConfig, FailureDocument, FieldsReport, IssuesCompleted, LocateReport, MetadataSet, NativeId, Priority, ProjectGraph, ProjectStatusSet, QueryResponseOfQualifiedDocument, QueryResponseOfQualifiedEdge, QueryResponseOfQualifiedLabel, QueryResponseOfQualifiedProject, QueryResponseOfQualifiedTask, QueryResponseOfSearchHit, Regenerated, RenderedTemplate, SourceListings, SourceRoute, StatusCategory, StatusesReconciled, StatusNamesReport, StatusOptionsReport, TaskAssetNames, TaskContentSet, TaskDetail, TaskDetails, TaskPrioritySet, TaskStatusSet, TaskUpdated, TemplateAnswers, TemplateVariables } from "./generated/models.ts";
+import type { CacheCleared, Classification, CommentList, CommentWritten, CopyReport, DeletedComment, DocumentDetail, EffectiveConfig, FailureDocument, FieldsReport, HumanTaskProjected, IssuesCompleted, LocateReport, MetadataSet, NativeId, Priority, ProjectGraph, ProjectStatusSet, QueryResponseOfQualifiedDocument, QueryResponseOfQualifiedEdge, QueryResponseOfQualifiedLabel, QueryResponseOfQualifiedProject, QueryResponseOfQualifiedTask, QueryResponseOfSearchHit, Regenerated, RenderedTemplate, SourceListings, SourceRoute, StatusCategory, StatusesReconciled, StatusNamesReport, StatusOptionsReport, TaskAssetNames, TaskContentSet, TaskDetail, TaskDetails, TaskPrioritySet, TaskStatusSet, TaskUpdated, TemplateAnswers, TemplateVariables } from "./generated/models.ts";
 import { runtimeSchemas } from "./generated/schemas.ts";
 export type QueryOptions = {
     sources?: string[];
@@ -238,6 +238,7 @@ export declare class OnetaskgraphClient {
     taskRender(id: string, options?: ItemRenderOptions): Promise<Regenerated>;
     taskAnswers(id: string): Promise<TemplateAnswers>;
     taskAssets(id: string, outputDir: string): Promise<TaskAssetNames>;
+    taskProjectHuman(input: string): Promise<HumanTaskProjected>;
     projectCreate(source: string, id: NativeId, title: string, options?: ProjectCreateOptions): Promise<QueryResponseOfQualifiedProject>;
     projectRender(id: string, options?: RenderOptions): Promise<Regenerated>;
     projectAnswers(id: string): Promise<TemplateAnswers>;

package/dist/generated/commands.d.ts

@@ -1 +1 @@
-export declare const binaryCommands: readonly ["schema", "config show", "sources list", "sources status-options", "sources fields", "sources route", "task list", "task show", "task show-many", "task deps", "task copy", "task locate", "task comment add", "task comment list", "task comment edit", "task comment delete", "task status set", "task status reconcile", "task status complete", "task priority set", "task content set", "task metadata set", "task update", "task create", "task render", "task answers", "task assets", "project list", "project show", "project deps", "project graph", "project copy", "project metadata set", "project status set", "project create", "project render", "project answers", "document list", "document show", "document copy", "document metadata set", "document create", "document render", "document answers", "label list", "search", "cache clear", "template variables", "template render"];
+export declare const binaryCommands: readonly ["schema", "config show", "sources list", "sources status-options", "sources fields", "sources route", "task list", "task show", "task show-many", "task deps", "task copy", "task locate", "task comment add", "task comment list", "task comment edit", "task comment delete", "task status set", "task status reconcile", "task status complete", "task priority set", "task content set", "task metadata set", "task update", "task create", "task render", "task answers", "task assets", "task project-human", "project list", "project show", "project deps", "project graph", "project copy", "project metadata set", "project status set", "project create", "project render", "project answers", "document list", "document show", "document copy", "document metadata set", "document create", "document render", "document answers", "label list", "search", "cache clear", "template variables", "template render"];

package/dist/generated/models.d.ts

@@ -1,4 +1,4 @@
-export declare const SCHEMA_BUNDLE_VERSION: 49;
+export declare const SCHEMA_BUNDLE_VERSION: 50;
 export declare namespace GeneratedAsset {
     /**
      * One asset a record holds, as a read reports it.
@@ -4135,6 +4135,100 @@ export declare namespace GeneratedHeldTask {
     }
 }
 export type HeldTask = GeneratedHeldTask.HeldTask;
+export declare namespace GeneratedHumanTaskProjected {
+    /**
+     * A durable projection's bound tracker identity, suitable for a directly clickable card.
+     */
+    interface HumanTaskProjected {
+        /**
+         * The resolved destination project.
+         */
+        project: string;
+        /**
+         * The resolved configured source.
+         */
+        source: string;
+        /**
+         * The qualified task identity.
+         */
+        task: string;
+        /**
+         * The canonical tracker issue URL.
+         */
+        url: string;
+    }
+}
+export type HumanTaskProjected = GeneratedHumanTaskProjected.HumanTaskProjected;
+export declare namespace GeneratedHumanTaskProjection {
+    /**
+     * A repository identified by its normalized origin, without a URL scheme or `.git` suffix.
+     */
+    type Repository = string;
+    /**
+     * Version 1 of the general human task projection request.
+     */
+    interface HumanTaskProjection {
+        /**
+         * The visible task content.
+         */
+        body: string;
+        /**
+         * The external idempotency identity, stable across producer retries.
+         */
+        item_id: string;
+        owner: ProjectionOwner;
+        /**
+         * Its priority, using the existing plugin API serialization.
+         */
+        priority: ("none" | "urgent" | "high" | "medium" | "low");
+        /**
+         * The plan's resolved destination project, or null for a configured human project.
+         */
+        project: (string | null);
+        /**
+         * An optional dismissal reason. Omission and null both preserve absence.
+         */
+        reason?: (string | null);
+        /**
+         * Normalized repository origins whose work this item concerns.
+         */
+        repositories: Repository[];
+        /**
+         * The wire contract version, always 1.
+         */
+        schema_version: 1;
+        /**
+         * The configured source through which placement is resolved.
+         */
+        source: string;
+        /**
+         * The desired lifecycle.
+         */
+        state: ("open" | "completed" | "dismissed");
+        /**
+         * The visible task title.
+         */
+        title: string;
+    }
+    /**
+     * The producer that owns the intent.
+     */
+    interface ProjectionOwner {
+        /**
+         * The owning plan, when applicable.
+         */
+        plan: (string | null);
+        /**
+         * The owning run, when applicable.
+         */
+        run: (string | null);
+        /**
+         * The owning session.
+         */
+        session: string;
+    }
+}
+export type HumanTaskProjection = GeneratedHumanTaskProjection.HumanTaskProjection;
 export declare namespace GeneratedIssueCompleted {
     /**
      * What keeping one delivered task in step with one deliverer came to.

package/dist/generated/schemas.d.ts

@@ -5493,6 +5493,172 @@ export declare const runtimeSchemas: {
         readonly title: "HeldTask";
         readonly type: "object";
     };
+    readonly HumanTaskProjected: {
+        readonly $defs: {
+            readonly SourceName: {
+                readonly description: "The name a configuration document gives one configured source.";
+                readonly pattern: "^[a-z0-9][a-z0-9-]*$";
+                readonly type: "string";
+            };
+        };
+        readonly $schema: "https://json-schema.org/draft/2020-12/schema";
+        readonly additionalProperties: false;
+        readonly description: "A durable projection's bound tracker identity, suitable for a directly clickable card.";
+        readonly properties: {
+            readonly project: {
+                readonly description: "The resolved destination project.";
+                readonly type: "string";
+            };
+            readonly source: {
+                readonly $ref: "#/$defs/SourceName";
+                readonly description: "The resolved configured source.";
+            };
+            readonly task: {
+                readonly description: "The qualified task identity.";
+                readonly type: "string";
+            };
+            readonly url: {
+                readonly description: "The canonical tracker issue URL.";
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["task", "url", "project", "source"];
+        readonly title: "HumanTaskProjected";
+        readonly type: "object";
+    };
+    readonly HumanTaskProjection: {
+        readonly $defs: {
+            readonly Priority: {
+                readonly description: "How much a task matters, in the one vocabulary every source is normalised into.\n\nFive values, most pressing first after [`None`](Self::None): Linear's own priority has\nexactly these, and a source whose backend has none of its own maps its representation\nonto them. `none` is a value rather than an absent field, because \"no priority is set\" is\nsomething a person sets — writing `none` clears a priority — and a reader tells it apart\nfrom nothing by the value alone.";
+                readonly oneOf: readonly [{
+                    readonly const: "none";
+                    readonly description: "No priority is set.";
+                    readonly type: "string";
+                }, {
+                    readonly const: "urgent";
+                    readonly description: "Drop everything for it.";
+                    readonly type: "string";
+                }, {
+                    readonly const: "high";
+                    readonly description: "Next, before the rest.";
+                    readonly type: "string";
+                }, {
+                    readonly const: "medium";
+                    readonly description: "In its turn.";
+                    readonly type: "string";
+                }, {
+                    readonly const: "low";
+                    readonly description: "When there is nothing more pressing.";
+                    readonly type: "string";
+                }];
+            };
+            readonly ProjectionOwner: {
+                readonly additionalProperties: false;
+                readonly description: "The producer that owns the intent; nullable run and plan are explicit on the wire.";
+                readonly properties: {
+                    readonly plan: {
+                        readonly description: "The owning plan, when applicable.";
+                        readonly type: readonly ["string", "null"];
+                    };
+                    readonly run: {
+                        readonly description: "The owning run, when applicable.";
+                        readonly type: readonly ["string", "null"];
+                    };
+                    readonly session: {
+                        readonly description: "The owning session.";
+                        readonly type: "string";
+                    };
+                };
+                readonly required: readonly ["session", "run", "plan"];
+                readonly type: "object";
+            };
+            readonly ProjectionState: {
+                readonly description: "The requested tracker lifecycle. Questions have no representation here.";
+                readonly oneOf: readonly [{
+                    readonly const: "open";
+                    readonly description: "The operator has work to do.";
+                    readonly type: "string";
+                }, {
+                    readonly const: "completed";
+                    readonly description: "The operator completed the work.";
+                    readonly type: "string";
+                }, {
+                    readonly const: "dismissed";
+                    readonly description: "The operator dismissed the work, optionally recording a reason.";
+                    readonly type: "string";
+                }];
+            };
+            readonly ProjectionVersion: {
+                readonly const: 1;
+                readonly type: "integer";
+            };
+            readonly Repository: {
+                readonly description: "A repository identified by its normalized origin, without a URL scheme or `.git` suffix.";
+                readonly type: "string";
+            };
+            readonly SourceName: {
+                readonly description: "The name a configuration document gives one configured source.";
+                readonly pattern: "^[a-z0-9][a-z0-9-]*$";
+                readonly type: "string";
+            };
+        };
+        readonly $schema: "https://json-schema.org/draft/2020-12/schema";
+        readonly additionalProperties: false;
+        readonly description: "Version 1 of the general human task projection request.";
+        readonly properties: {
+            readonly body: {
+                readonly description: "The visible task content.";
+                readonly type: "string";
+            };
+            readonly item_id: {
+                readonly description: "The external idempotency identity, stable across producer retries.";
+                readonly type: "string";
+            };
+            readonly owner: {
+                readonly $ref: "#/$defs/ProjectionOwner";
+                readonly description: "The producer that owns the intent.";
+            };
+            readonly priority: {
+                readonly $ref: "#/$defs/Priority";
+                readonly description: "Its priority, using the existing plugin API serialization.";
+            };
+            readonly project: {
+                readonly description: "The plan's resolved destination project, or null for a configured human project.";
+                readonly type: readonly ["string", "null"];
+            };
+            readonly reason: {
+                readonly default: null;
+                readonly description: "An optional dismissal reason. Omission and null both preserve absence.";
+                readonly type: readonly ["string", "null"];
+            };
+            readonly repositories: {
+                readonly description: "Normalized repository origins whose work this item concerns.";
+                readonly items: {
+                    readonly $ref: "#/$defs/Repository";
+                };
+                readonly type: "array";
+            };
+            readonly schema_version: {
+                readonly $ref: "#/$defs/ProjectionVersion";
+                readonly description: "The wire contract version, always 1.";
+            };
+            readonly source: {
+                readonly $ref: "#/$defs/SourceName";
+                readonly description: "The configured source through which placement is resolved.";
+            };
+            readonly state: {
+                readonly $ref: "#/$defs/ProjectionState";
+                readonly description: "The desired lifecycle.";
+            };
+            readonly title: {
+                readonly description: "The visible task title.";
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["schema_version", "item_id", "owner", "title", "body", "priority", "repositories", "project", "source", "state"];
+        readonly title: "HumanTaskProjection";
+        readonly type: "object";
+    };
     readonly IssueCompleted: {
         readonly $defs: {
             readonly CompleteAction: {

package/dist/index.d.ts

@@ -6,6 +6,6 @@
  * implementation of the query semantics across the CLI and both SDKs.
  */
 /** The version this package publishes. `package.json` must agree; see the tests. */
-export declare const VERSION = "0.12.11";
+export declare const VERSION = "0.12.13";
 export * from "./client.ts";
 export type * from "./generated/models.ts";

package/dist/index.js

@@ -7167,6 +7167,7 @@ var binaryCommands = [
   "task render",
   "task answers",
   "task assets",
+  "task project-human",
   "project list",
   "project show",
   "project deps",
@@ -7192,7 +7193,7 @@ var binaryCommands = [
 ];
 
 // src/generated/models.ts
-var SCHEMA_BUNDLE_VERSION = 49;
+var SCHEMA_BUNDLE_VERSION = 50;
 
 // src/generated/schemas.ts
 var runtimeSchemas = {
@@ -14724,6 +14725,220 @@ at one.`,
     title: "HeldTask",
     type: "object"
   },
+  HumanTaskProjected: {
+    $defs: {
+      SourceName: {
+        description: "The name a configuration document gives one configured source.",
+        pattern: "^[a-z0-9][a-z0-9-]*$",
+        type: "string"
+      }
+    },
+    $schema: "https://json-schema.org/draft/2020-12/schema",
+    additionalProperties: false,
+    description: "A durable projection's bound tracker identity, suitable for a directly clickable card.",
+    properties: {
+      project: {
+        description: "The resolved destination project.",
+        type: "string"
+      },
+      source: {
+        $ref: "#/$defs/SourceName",
+        description: "The resolved configured source."
+      },
+      task: {
+        description: "The qualified task identity.",
+        type: "string"
+      },
+      url: {
+        description: "The canonical tracker issue URL.",
+        type: "string"
+      }
+    },
+    required: [
+      "task",
+      "url",
+      "project",
+      "source"
+    ],
+    title: "HumanTaskProjected",
+    type: "object"
+  },
+  HumanTaskProjection: {
+    $defs: {
+      Priority: {
+        description: `How much a task matters, in the one vocabulary every source is normalised into.
+
+Five values, most pressing first after [\`None\`](Self::None): Linear's own priority has
+exactly these, and a source whose backend has none of its own maps its representation
+onto them. \`none\` is a value rather than an absent field, because "no priority is set" is
+something a person sets — writing \`none\` clears a priority — and a reader tells it apart
+from nothing by the value alone.`,
+        oneOf: [
+          {
+            const: "none",
+            description: "No priority is set.",
+            type: "string"
+          },
+          {
+            const: "urgent",
+            description: "Drop everything for it.",
+            type: "string"
+          },
+          {
+            const: "high",
+            description: "Next, before the rest.",
+            type: "string"
+          },
+          {
+            const: "medium",
+            description: "In its turn.",
+            type: "string"
+          },
+          {
+            const: "low",
+            description: "When there is nothing more pressing.",
+            type: "string"
+          }
+        ]
+      },
+      ProjectionOwner: {
+        additionalProperties: false,
+        description: "The producer that owns the intent; nullable run and plan are explicit on the wire.",
+        properties: {
+          plan: {
+            description: "The owning plan, when applicable.",
+            type: [
+              "string",
+              "null"
+            ]
+          },
+          run: {
+            description: "The owning run, when applicable.",
+            type: [
+              "string",
+              "null"
+            ]
+          },
+          session: {
+            description: "The owning session.",
+            type: "string"
+          }
+        },
+        required: [
+          "session",
+          "run",
+          "plan"
+        ],
+        type: "object"
+      },
+      ProjectionState: {
+        description: "The requested tracker lifecycle. Questions have no representation here.",
+        oneOf: [
+          {
+            const: "open",
+            description: "The operator has work to do.",
+            type: "string"
+          },
+          {
+            const: "completed",
+            description: "The operator completed the work.",
+            type: "string"
+          },
+          {
+            const: "dismissed",
+            description: "The operator dismissed the work, optionally recording a reason.",
+            type: "string"
+          }
+        ]
+      },
+      ProjectionVersion: {
+        const: 1,
+        type: "integer"
+      },
+      Repository: {
+        description: "A repository identified by its normalized origin, without a URL scheme or `.git` suffix.",
+        type: "string"
+      },
+      SourceName: {
+        description: "The name a configuration document gives one configured source.",
+        pattern: "^[a-z0-9][a-z0-9-]*$",
+        type: "string"
+      }
+    },
+    $schema: "https://json-schema.org/draft/2020-12/schema",
+    additionalProperties: false,
+    description: "Version 1 of the general human task projection request.",
+    properties: {
+      body: {
+        description: "The visible task content.",
+        type: "string"
+      },
+      item_id: {
+        description: "The external idempotency identity, stable across producer retries.",
+        type: "string"
+      },
+      owner: {
+        $ref: "#/$defs/ProjectionOwner",
+        description: "The producer that owns the intent."
+      },
+      priority: {
+        $ref: "#/$defs/Priority",
+        description: "Its priority, using the existing plugin API serialization."
+      },
+      project: {
+        description: "The plan's resolved destination project, or null for a configured human project.",
+        type: [
+          "string",
+          "null"
+        ]
+      },
+      reason: {
+        default: null,
+        description: "An optional dismissal reason. Omission and null both preserve absence.",
+        type: [
+          "string",
+          "null"
+        ]
+      },
+      repositories: {
+        description: "Normalized repository origins whose work this item concerns.",
+        items: {
+          $ref: "#/$defs/Repository"
+        },
+        type: "array"
+      },
+      schema_version: {
+        $ref: "#/$defs/ProjectionVersion",
+        description: "The wire contract version, always 1."
+      },
+      source: {
+        $ref: "#/$defs/SourceName",
+        description: "The configured source through which placement is resolved."
+      },
+      state: {
+        $ref: "#/$defs/ProjectionState",
+        description: "The desired lifecycle."
+      },
+      title: {
+        description: "The visible task title.",
+        type: "string"
+      }
+    },
+    required: [
+      "schema_version",
+      "item_id",
+      "owner",
+      "title",
+      "body",
+      "priority",
+      "repositories",
+      "project",
+      "source",
+      "state"
+    ],
+    title: "HumanTaskProjection",
+    type: "object"
+  },
   IssueCompleted: {
     $defs: {
       CompleteAction: {
@@ -35312,6 +35527,7 @@ var commandResponseRoots = {
   "task render": "Regenerated",
   "task answers": "TemplateAnswers",
   "task assets": "TaskAssetNames",
+  "task project-human": "HumanTaskProjected",
   "document create": "DocumentDetail",
   "document render": "Regenerated",
   "document answers": "TemplateAnswers"
@@ -35319,7 +35535,7 @@ var commandResponseRoots = {
 var commandAlternateRoots = {
   "sources fields": ["StatusNamesReport"]
 };
-var partialResponseCommands = new Set(Object.keys(commandResponseRoots).filter((command) => command !== "config show" && command !== "cache clear" && command !== "sources list" && command !== "sources fields" && command !== "sources route" && command !== "project graph" && !command.startsWith("task comment ") && !command.endsWith(" metadata set") && !command.endsWith(" priority set") && !command.endsWith(" content set") && !command.startsWith("template ") && !command.endsWith(" render") && !command.endsWith(" answers") && command !== "task assets" && command !== "project create" && command !== "document create"));
+var partialResponseCommands = new Set(Object.keys(commandResponseRoots).filter((command) => command !== "config show" && command !== "cache clear" && command !== "sources list" && command !== "sources fields" && command !== "sources route" && command !== "project graph" && !command.startsWith("task comment ") && !command.endsWith(" metadata set") && !command.endsWith(" priority set") && !command.endsWith(" content set") && !command.startsWith("template ") && !command.endsWith(" render") && !command.endsWith(" answers") && command !== "task assets" && command !== "task project-human" && command !== "project create" && command !== "document create"));
 function bodyArguments(options) {
   return "bodyFile" in options ? { args: ["--body-file", options.bodyFile] } : { args: [], input: options.body };
 }
@@ -36066,6 +36282,12 @@ class OnetaskgraphClient {
   taskAssets(id, outputDir) {
     return this.run("task assets", [id, "--output-dir", outputDir]);
   }
+  taskProjectHuman(input) {
+    return this.run("task project-human", [
+      "--input",
+      stringOption("taskProjectHuman", "input", input)
+    ]);
+  }
   async projectCreate(source, id, title, options = {}) {
     const { args, input } = createArguments("projectCreate", ["--id", id, "--title", title], options);
     if (options.status !== undefined)
@@ -36157,7 +36379,7 @@ function assertCompleteCommandSurface() {
 }
 
 // src/index.ts
-var VERSION = "0.12.11";
+var VERSION = "0.12.13";
 export {
   taskUpdateOptionFlags,
   taskUpdateFlags,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@onetaskgraph/sdk",
   "//": "llmlint: ignore-file[projects_stay_in_one_js_workspace] This package IS the JS workspace's one member; what the rule reads as a second is the optionalDependency below, which is the published launcher an end user installs beside the SDK and resolves from the registry at their own install. `workspace:*` names nothing there, and npm/cli is not a workspace member for the reason its own manifest records. scripts/set-version.sh writes this number and `--check` refuses any other, under distribution-check. JSON has no comment to scope this to the one line.",
-  "version": "0.12.11",
+  "version": "0.12.13",
   "description": "The TypeScript SDK for onetaskgraph, generated from the binary's own JSON Schema bundle.",
   "license": "MIT",
   "type": "module",
@@ -28,7 +28,7 @@
     "generate:check": "bun scripts/generate.ts --check"
   },
   "optionalDependencies": {
-    "@onetaskgraph/cli": "0.12.11"
+    "@onetaskgraph/cli": "0.12.13"
   },
   "devDependencies": {
     "ajv": "8.17.1",