tines 0.0.159 → 0.0.160

package/dist/index.js

@@ -6611,6 +6611,32 @@ function registerEvents(program3) {
 // src/commands/projects.ts
 function register6(program3) {
   const projects = program3.command("projects").description("Manage projects");
+  withCommon(
+    projects.command("starters").description("List built-in project starters and their inputs")
+  ).action(async (opts) => {
+    const response = await client(opts).listStarters();
+    if (opts.json) return printJson(response);
+    for (const starter of response.items) {
+      console.log(`${starter.id} \u2014 ${starter.name}`);
+      console.log(`  ${starter.description}`);
+      for (const input of starter.inputs) {
+        console.log(
+          `  --${inputFlag(input)}${input.required ? " (required)" : " (optional)"} \u2014 ${input.description ?? input.label}`
+        );
+      }
+      for (const workflow of starter.creates.workflows) {
+        console.log(
+          `  workflow: ${workflow.name}${workflow.default ? " (default)" : ""} \u2014 ${workflow.states.join(" \u2192 ")}`
+        );
+      }
+      for (const item of starter.creates.context) console.log(`  ${item.kind}: ${item.name}`);
+      if (starter.creates.first_issue) {
+        const issue = starter.creates.first_issue;
+        console.log(`  first issue: ${issue.title} \u2014 ${issue.state} (${issue.workflow})`);
+      }
+      if (isBlank(starter)) console.log("  requires --prompt or --no-prompt when creating");
+    }
+  });
   withList(
     projects.command("list").description("List projects").option("--archived", "include archived projects (hidden by default)")
   ).action(async (opts) => {
@@ -6634,29 +6660,96 @@ function register6(program3) {
     });
   });
   withCommon(
-    projects.command("create <name>").description("Create a project (with its initial context prompt)").option("-d, --description <text>", "project description").option("-w, --default-workflow <id-or-name>", "default workflow for new issues").option(
+    projects.command("create <name>").description(
+      "Create a project; nonblank starters supply a conventions template unless --prompt or --no-prompt overrides it"
+    ).option("-d, --description <text>", "project description").option(
+      "-w, --default-workflow <id-or-name>",
+      "default workflow for new issues (conflicts with a starter that sets one)"
+    ).option("--starter <id>", "built-in starter (discover with `tines projects starters`)").option("--repo <url>", "repository URL for the code starter").option("--branch <branch>", "repository branch for the code starter").option("--brief <text>", "planning brief for the plan starter").option(
       "--prompt <md>",
-      "initial conventions prompt, stitched into every issue's agent prompt: inline Markdown or @file"
-    ).option("--no-prompt", "create without an initial prompt")
+      "override the starter's conventions template: inline Markdown or @file"
+    ).option(
+      "--no-prompt",
+      "omit the starter's conventions template (other starter context remains)"
+    )
   ).action(
     async (name2, opts) => {
-      if (opts.prompt === void 0 || opts.prompt === true) {
+      const prompt = typeof opts.prompt === "string" ? readBodyValue(opts.prompt) : void 0;
+      const suppliedInputs = [
+        ["repo_url", "--repo", opts.repo],
+        ["repo_branch", "--branch", opts.branch],
+        ["brief", "--brief", opts.brief]
+      ];
+      if (!opts.starter && suppliedInputs.some(([, , value]) => value !== void 0)) {
         die(
-          'every issue in a project inherits its context \u2014 give the project an initial prompt:\n  --prompt "<markdown>"   house conventions, inline or @file\n  --no-prompt             create without one (add later: tines context create -k prompt -n conventions -p <name> --body \u2026)'
+          "starter input flags require --starter (discover choices with `tines projects starters`)"
         );
       }
       const api = client(opts);
+      let starter;
+      let starterRequest;
+      if (opts.starter) {
+        const response = await api.listStarters();
+        starter = response.items.find((item) => item.id === opts.starter);
+        if (!starter) {
+          die(
+            `unknown starter "${opts.starter}"; choose ${response.items.map((item) => item.id).join(", ")} (see \`tines projects starters\`)`
+          );
+        }
+        const declared = new Map(starter.inputs.map((input) => [input.key, input]));
+        for (const [key, flag, value] of suppliedInputs) {
+          if (value !== void 0 && !declared.has(key))
+            die(`${flag} is not used by starter "${starter.id}"`);
+        }
+        const inputs = {};
+        for (const [key, , value] of suppliedInputs) {
+          if (value !== void 0 && declared.has(key)) inputs[key] = value.trim();
+        }
+        for (const input of starter.inputs) {
+          const value = inputs[input.key] ?? "";
+          if (input.required && !value)
+            die(`starter "${starter.id}" requires --${inputFlag(input)}`);
+          const max = input.max ?? 1e4;
+          if (value.length > max) die(`--${inputFlag(input)} is longer than ${max} characters`);
+        }
+        if (starter.creates.workflows.some((workflow) => workflow.default) && opts.defaultWorkflow) {
+          die(`starter "${starter.id}" sets the default workflow; do not pass --default-workflow`);
+        }
+        starterRequest = { id: starter.id, inputs };
+      }
+      if ((!starter || isBlank(starter)) && (opts.prompt === void 0 || opts.prompt === true)) {
+        die(
+          'every issue in a project inherits its context \u2014 give the project an initial prompt:\n  --prompt "<markdown>"   house conventions, inline or @file\n  --no-prompt             create without one (add later: tines context create -k prompt -n conventions -p <name> --body \u2026)'
+        );
+      }
       const workflowId = opts.defaultWorkflow ? (await resolveWorkflow(api, opts.defaultWorkflow)).id : void 0;
-      const project = await api.createProject({
+      const body = {
         name: name2,
         description: opts.description,
         default_workflow_id: workflowId,
-        initial_prompt: typeof opts.prompt === "string" ? readBodyValue(opts.prompt) : void 0
-      });
+        ...typeof opts.prompt === "string" ? { initial_prompt: prompt } : opts.prompt === false ? { initial_prompt: "" } : {},
+        ...starterRequest ? { starter: starterRequest } : {}
+      };
+      const project = await api.createProject(body);
       if (opts.json) return printJson(project);
       console.log(
         `created project "${project.name}" (${project.id})${typeof opts.prompt === "string" ? ' with its "conventions" prompt' : ""}`
       );
+      if (project.starter) {
+        for (const workflow of project.starter.workflows) {
+          console.log(
+            `workflow: ${workflow.name} (${workflow.id})${workflow.reused ? " \u2014 reused" : ""}`
+          );
+        }
+        for (const item of project.starter.context)
+          console.log(`context: ${item.kind} \u201C${item.name}\u201D`);
+        if (project.starter.first_issue) {
+          const issue = project.starter.first_issue;
+          console.log(`first issue: ${issue.ref} \u2014 ${issue.state_name}`);
+          console.log(`tines issues show "${issue.ref}"`);
+        }
+        console.log(`Next: get an agent running \u2014 ${resolveUrl(opts).replace(/\/$/, "")}/agents`);
+      }
     }
   );
   withCommon(projects.command("show <id-or-name>").description("Show a project")).action(
@@ -6730,6 +6823,14 @@ default workflow: ${defaultWorkflow}`);
     console.log(`deleted project "${project.name}" (${project.id})`);
   });
 }
+function inputFlag(input) {
+  if (input.key === "repo_url") return "repo";
+  if (input.key === "repo_branch") return "branch";
+  return input.key.replaceAll("_", "-");
+}
+function isBlank(starter) {
+  return starter.creates.workflows.length === 0 && starter.creates.context.length === 0 && starter.creates.first_issue === null;
+}
 
 // src/commands/routing.ts
 async function resolveRoutingScope(api, opts) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tines",
-  "version": "0.0.159",
+  "version": "0.0.160",
   "description": "CLI for Tines, an orchestration layer for AI agents",
   "repository": {
     "type": "git",