@bvdm/delano 0.2.4 → 0.2.6

package/src/cli/commands/wrapper.js

@@ -1,13 +1,19 @@
+const path = require("node:path");
+
 const { runPmScript } = require("../lib/pm");
 
-function createWrapperCommand(scriptName) {
+function createWrapperCommand(scriptName, options = {}) {
   return {
-    description: `Run .agents/scripts/pm/${scriptName}.sh in the current Delano repository.`,
+    description: options.description || `Run .agents/scripts/pm/${scriptName}.sh in the current Delano repository.`,
     run(args) {
       const passthrough = args[0] === "--" ? args.slice(1) : args;
-      return runPmScript(scriptName, passthrough);
+      return runPmScript(scriptName, normalizePassthrough(scriptName, passthrough));
     },
     help() {
+      if (typeof options.help === "function") {
+        return options.help();
+      }
+
       const lines = [
         "Usage:",
         `  delano ${scriptName} [-- <script-args>]`,
@@ -32,6 +38,13 @@ function createWrapperCommand(scriptName) {
   };
 }
 
+function normalizePassthrough(scriptName, args) {
+  if (scriptName !== "import-spec-kit" || args.length < 2 || path.isAbsolute(args[1])) {
+    return args;
+  }
+  return [args[0], path.resolve(process.cwd(), args[1]), ...args.slice(2)];
+}
+
 module.exports = {
   createWrapperCommand
 };

package/src/cli/index.js

@@ -7,9 +7,28 @@ const { getOnboardingHelp, runOnboarding } = require("./commands/onboarding");
 const { runInstall, getInstallHelp } = require("./commands/install");
 const { runViewer, getViewerHelp } = require("./commands/viewer");
 const { createWrapperCommand } = require("./commands/wrapper");
+const {
+  getProjectHelp,
+  getTaskHelp,
+  getUpdateHelp,
+  getWorkstreamHelp,
+  parseTaskArgs,
+  runProjectCommand,
+  runTaskCommand,
+  runUpdateCommand,
+  runWorkstreamCommand
+} = require("./commands/state");
 
 const wrapperCommands = {
   init: createWrapperCommand("init"),
+  "import-spec-kit": createWrapperCommand("import-spec-kit", {
+    description: "Create a planned Delano project from a Spec Kit-style markdown artifact.",
+    help: getImportSpecKitHelp
+  }),
+  research: createWrapperCommand("research", {
+    description: "Create repo-native research intake files for a Delano project.",
+    help: getResearchHelp
+  }),
   validate: createWrapperCommand("validate"),
   status: createWrapperCommand("status"),
   next: createWrapperCommand("next")
@@ -31,18 +50,36 @@ const commands = {
     run: runViewer,
     help: getViewerHelp
   },
+  project: {
+    description: "Create, show, and patch Delano project contracts.",
+    run: runProjectCommand,
+    help: getProjectHelp
+  },
+  workstream: {
+    description: "Add and patch Delano workstream contracts.",
+    run: runWorkstreamCommand,
+    help: getWorkstreamHelp
+  },
+  task: {
+    description: "Add and patch Delano task contracts with scoped lifecycle rollups.",
+    run: runTaskCommand,
+    help: getTaskHelp
+  },
+  update: {
+    description: "Add project progress updates from the project update template.",
+    run: runUpdateCommand,
+    help: getUpdateHelp
+  },
   init: wrapperCommands.init,
+  "import-spec-kit": wrapperCommands["import-spec-kit"],
+  research: wrapperCommands.research,
   validate: wrapperCommands.validate,
   status: wrapperCommands.status,
   next: wrapperCommands.next
 };
 
 function isInstallShorthand(argv) {
-  if (argv.length === 0) {
-    return false;
-  }
-
-  return argv[0].startsWith("-");
+  return argv.length > 0 && argv[0].startsWith("-");
 }
 
 function resolveInvocation(argv) {
@@ -99,8 +136,14 @@ function getGeneralHelp() {
     "  onboarding Analyze AGENTS.md with the approval-first onboarding skill",
     "  install    Install the approved Delano runtime payload",
     "  viewer     Launch the read-only local UI for .project contracts",
-    "  init       Run .agents/scripts/pm/init.sh in the current Delano repo",
-    "  validate   Run .agents/scripts/pm/validate.sh in the current Delano repo",
+    "  project    Create, show, and patch project contracts",
+    "  workstream Add and patch workstream contracts",
+    "  task       Add and patch task contracts with scoped lifecycle rollups",
+    "  update     Add a progress update from .project/templates",
+    "  init            Run .agents/scripts/pm/init.sh in the current Delano repo",
+    "  import-spec-kit Create a planned project from a Spec Kit-style markdown artifact",
+    "  research        Create repo-native research intake files for a project",
+    "  validate        Run .agents/scripts/pm/validate.sh in the current Delano repo",
     "  status     Run .agents/scripts/pm/status.sh in the current Delano repo",
     "  next       Run .agents/scripts/pm/next.sh in the current Delano repo",
     "",
@@ -115,6 +158,14 @@ function getGeneralHelp() {
     "  delano --target ../my-repo --yes",
     "  npx -y @bvdm/delano@latest --yes",
     "  delano viewer",
+    "  delano project create my-project --name \"My Project\" --owner team",
+    "  delano workstream add my-project WS-A --name \"API Foundation\" --owner backend-team",
+    "  delano task add my-project T-001 --name \"Build endpoint\" --workstream WS-A",
+    "  delano task start my-project T-001",
+    "  delano task close my-project T-001 --evidence \"Implemented and tested\"",
+    "  delano update add my-project --message \"Implemented endpoint smoke test\"",
+    "  delano import-spec-kit reminder-email-preferences docs/spec-kit/fixtures/minimal-spec-kit-project.md --json",
+    "  delano research my-project api-options --title \"API options\" --question \"Which API shape should we use?\" --json",
     "  delano validate",
     "  delano status --open --brief",
     "  delano next -- --all",
@@ -129,6 +180,63 @@ function getGeneralHelp() {
   ].join("\n");
 }
 
+function getResearchHelp() {
+  return [
+    "Usage:",
+    "  delano research <project-slug> <research-slug> [options]",
+    "",
+    "Creates repo-native research intake files under .project/projects/<project-slug>/research/<research-slug>/, then runs Delano validation by default.",
+    "",
+    "Arguments:",
+    "  project-slug          Existing Delano project slug",
+    "  research-slug         Research folder slug in kebab-case",
+    "",
+    "Options:",
+    "  --title <title>        Human-readable research title",
+    "  --question <question>  Primary research question",
+    "  --owner <owner>        Research owner, defaults to team",
+    "  --no-validate          Create artifacts without running Delano validation",
+    "  --json                 Print a single machine-readable JSON result",
+    "  -h, --help             Show help",
+    "",
+    "Agent examples:",
+    "  delano research delano-spec-kit-interop import-edge-cases --title \"Import edge cases\" --question \"Which inputs should block import?\" --json",
+    "",
+    "Output:",
+    "  Human mode prints a concise summary plus validation output.",
+    "  JSON mode prints: { ok, command, project, research, files, validation }."
+  ].join("\n");
+}
+
+function getImportSpecKitHelp() {
+  return [
+    "Usage:",
+    "  delano import-spec-kit <slug> <source-md> [options]",
+    "",
+    "Creates a planned Delano project from the first supported Spec Kit-style markdown fixture, then runs Delano validation by default.",
+    "",
+    "Arguments:",
+    "  slug                  Target Delano project slug in kebab-case",
+    "  source-md             Path to the markdown source artifact",
+    "",
+    "Options:",
+    "  --name <project-name>  Project name override",
+    "  --owner <owner>        Project owner, defaults to team",
+    "  --lead <lead>          Project lead, defaults to owner",
+    "  --no-validate          Create artifacts without running Delano validation",
+    "  --json                 Print a single machine-readable JSON result",
+    "  -h, --help             Show help",
+    "",
+    "Agent examples:",
+    "  delano import-spec-kit reminder-email-preferences docs/spec-kit/fixtures/minimal-spec-kit-project.md --json",
+    "  delano import-spec-kit reminder-email-preferences input.md --name \"Reminder Email Preferences\" --owner platform --lead clark --json",
+    "",
+    "Output:",
+    "  Human mode prints a concise summary plus validation output.",
+    "  JSON mode prints: { ok, command, project, source, validation }."
+  ].join("\n");
+}
+
 async function run(argv) {
   const invocation = resolveInvocation(argv);
 
@@ -156,6 +264,10 @@ async function run(argv) {
 module.exports = {
   commands,
   getGeneralHelp,
+  getImportSpecKitHelp,
+  getResearchHelp,
+  getTaskHelp,
+  parseTaskArgs,
   resolveInvocation,
   run
 };