@bvdm/delano 0.2.0 → 0.2.2

package/assets/payload/.delano/viewer/public/vscode.svg

@@ -1,24 +1,24 @@
-<?xml version="1.0" encoding="utf-8"?><!-- Uploaded to: SVG Repo, www.svgrepo.com, Generator: SVG Repo Mixer Tools -->
-<svg width="800px" height="800px" viewBox="0 0 32 32" fill="none" xmlns="http://www.w3.org/2000/svg">
-<path d="M21.0016 3.11679C21.0016 2.23783 20.0175 2.23782 19.5801 2.34769C20.1924 1.86426 20.9105 1.98147 21.1656 2.12796L27.079 5.02747C27.6424 5.30375 27.9998 5.8786 27.9998 6.50857V25.5831C27.9998 26.2215 27.6329 26.8025 27.058 27.0743L21.4937 29.7054C21.1109 29.8701 20.2799 30.2767 19.5801 29.7053C20.4549 29.8702 20.9287 29.2476 21.0016 28.8264V3.11679Z" fill="url(#paint0_linear_87_8101)"/>
-<path d="M19.6512 2.3319C20.1154 2.24017 21.0018 2.28271 21.0018 3.11685V9.68254L3.07359 23.2453C2.76022 23.4824 2.3192 23.443 2.05229 23.1542L0.204532 21.1548C-0.0849358 20.8416 -0.0646824 20.3513 0.249624 20.0633L19.5802 2.34775L19.6512 2.3319Z" fill="url(#paint1_linear_87_8101)"/>
-<path d="M21.0018 22.3708L3.07359 8.80801C2.76022 8.57094 2.3192 8.61028 2.05229 8.8991L0.204532 10.8985C-0.0849358 11.2117 -0.0646824 11.702 0.249624 11.9901L19.5802 29.7056C20.455 29.8704 20.9289 29.2478 21.0018 28.8266V22.3708Z" fill="url(#paint2_linear_87_8101)"/>
-<defs>
-<linearGradient id="paint0_linear_87_8101" x1="23.79" y1="2" x2="23.79" y2="30" gradientUnits="userSpaceOnUse">
-<stop stop-color="#32B5F1"/>
-<stop offset="1" stop-color="#2B9FED"/>
-</linearGradient>
-<linearGradient id="paint1_linear_87_8101" x1="21.0018" y1="5.53398" x2="1.0217" y2="22.3051" gradientUnits="userSpaceOnUse">
-<stop stop-color="#0F6FB3"/>
-<stop offset="0.270551" stop-color="#1279B7"/>
-<stop offset="0.421376" stop-color="#1176B5"/>
-<stop offset="0.618197" stop-color="#0E69AC"/>
-<stop offset="0.855344" stop-color="#0F70AF"/>
-<stop offset="1" stop-color="#0F6DAD"/>
-</linearGradient>
-<linearGradient id="paint2_linear_87_8101" x1="1.15522" y1="9.98389" x2="21.0791" y2="26.4808" gradientUnits="userSpaceOnUse">
-<stop stop-color="#1791D2"/>
-<stop offset="1" stop-color="#1173C5"/>
-</linearGradient>
-</defs>
+<?xml version="1.0" encoding="utf-8"?><!-- Uploaded to: SVG Repo, www.svgrepo.com, Generator: SVG Repo Mixer Tools -->
+<svg width="800px" height="800px" viewBox="0 0 32 32" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M21.0016 3.11679C21.0016 2.23783 20.0175 2.23782 19.5801 2.34769C20.1924 1.86426 20.9105 1.98147 21.1656 2.12796L27.079 5.02747C27.6424 5.30375 27.9998 5.8786 27.9998 6.50857V25.5831C27.9998 26.2215 27.6329 26.8025 27.058 27.0743L21.4937 29.7054C21.1109 29.8701 20.2799 30.2767 19.5801 29.7053C20.4549 29.8702 20.9287 29.2476 21.0016 28.8264V3.11679Z" fill="url(#paint0_linear_87_8101)"/>
+<path d="M19.6512 2.3319C20.1154 2.24017 21.0018 2.28271 21.0018 3.11685V9.68254L3.07359 23.2453C2.76022 23.4824 2.3192 23.443 2.05229 23.1542L0.204532 21.1548C-0.0849358 20.8416 -0.0646824 20.3513 0.249624 20.0633L19.5802 2.34775L19.6512 2.3319Z" fill="url(#paint1_linear_87_8101)"/>
+<path d="M21.0018 22.3708L3.07359 8.80801C2.76022 8.57094 2.3192 8.61028 2.05229 8.8991L0.204532 10.8985C-0.0849358 11.2117 -0.0646824 11.702 0.249624 11.9901L19.5802 29.7056C20.455 29.8704 20.9289 29.2478 21.0018 28.8266V22.3708Z" fill="url(#paint2_linear_87_8101)"/>
+<defs>
+<linearGradient id="paint0_linear_87_8101" x1="23.79" y1="2" x2="23.79" y2="30" gradientUnits="userSpaceOnUse">
+<stop stop-color="#32B5F1"/>
+<stop offset="1" stop-color="#2B9FED"/>
+</linearGradient>
+<linearGradient id="paint1_linear_87_8101" x1="21.0018" y1="5.53398" x2="1.0217" y2="22.3051" gradientUnits="userSpaceOnUse">
+<stop stop-color="#0F6FB3"/>
+<stop offset="0.270551" stop-color="#1279B7"/>
+<stop offset="0.421376" stop-color="#1176B5"/>
+<stop offset="0.618197" stop-color="#0E69AC"/>
+<stop offset="0.855344" stop-color="#0F70AF"/>
+<stop offset="1" stop-color="#0F6DAD"/>
+</linearGradient>
+<linearGradient id="paint2_linear_87_8101" x1="1.15522" y1="9.98389" x2="21.0791" y2="26.4808" gradientUnits="userSpaceOnUse">
+<stop stop-color="#1791D2"/>
+<stop offset="1" stop-color="#1173C5"/>
+</linearGradient>
+</defs>
 </svg>

package/package.json

@@ -1,8 +1,16 @@
 {
   "name": "@bvdm/delano",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "CLI for the Delano delivery runtime.",
-  "license": "UNLICENSED",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/MajesteitBart/delano"
+  },
+  "bugs": {
+    "url": "https://github.com/MajesteitBart/delano/issues"
+  },
+  "homepage": "https://github.com/MajesteitBart/delano#readme",
   "bin": {
     "delano": "bin/delano.js"
   },

package/src/cli/commands/install.js

@@ -2,6 +2,7 @@ const {
   applyInstallPlan,
   buildInstallPlan,
   collectConflicts,
+  configureInteractiveInstall,
   confirmInstall,
   parseInstallArgs,
   printConflicts,
@@ -17,24 +18,43 @@ function getInstallHelp() {
     "Options:",
     "  --target <dir>     Install into the given directory. Defaults to the current working directory.",
     "  --agents <list>    Comma-separated agent list for future opt-in adapter docs: claude,codex,opencode,pi.",
+    "  --only <list>      Install only selected categories.",
+    "  --exclude <list>   Omit selected categories from the install plan.",
+    "  --no-project-state Omit .project/context, .project/projects, and .project/registry.",
+    "  --no-project-context",
+    "                    Omit .project/context starter templates.",
+    "  --interactive     Choose an install preset and target in the terminal.",
+    "  --tui             Alias for --interactive.",
     "  --force            Overwrite existing allowlisted target paths. Does not override parent-path blockers.",
     "  --yes              Skip the final confirmation prompt.",
     "  -h, --help         Show command help.",
     "",
+    "Categories:",
+    "  agent-runtime, skills, viewer, project-context, project-templates,",
+    "  project-registry, project-projects, handbook, legacy-installer",
+    "",
     "Behavior:",
     "  - Computes the full install plan before writing files.",
     "  - Aborts on conflicts by default.",
+    "  - Filters the plan before conflict detection when --only or --exclude is used.",
+    "  - Treats .project/context, .project/projects, and .project/registry as repo-owned state after install.",
     "  - Only installs the approved base payload; top-level adapter entry docs remain opt-in and are not installed in v1.",
     "",
     "Examples:",
+    "  delano install --interactive",
     "  delano install --target ../repo --yes",
+    "  delano install --only skills,project-templates --force --yes",
+    "  delano install --exclude project-context,project-projects,project-registry --force --yes",
     "  delano --yes",
     "  npx -y @bvdm/delano@latest --yes"
   ].join("\n");
 }
 
 async function runInstall(args) {
-  const options = parseInstallArgs(args);
+  let options = parseInstallArgs(args);
+  if (options.interactive) {
+    options = await configureInteractiveInstall(options);
+  }
   const plan = buildInstallPlan(options);
   const conflicts = collectConflicts(plan);
   const unforceableConflicts = conflicts.filter((conflict) => !conflict.forceable);

package/src/cli/lib/install.js

@@ -8,13 +8,110 @@ const {
   statSync,
 } = require("node:fs");
 const path = require("node:path");
-const readline = require("node:readline/promises");
+const readline = require("node:readline");
 const { stdin, stdout } = require("node:process");
 
 const { CliError } = require("./errors");
 const { getPackageRoot, getPathType } = require("./runtime");
 
 const SUPPORTED_AGENTS = ["claude", "codex", "opencode", "pi"];
+const INSTALL_CATEGORIES = [
+  {
+    name: "agent-runtime",
+    description: ".agents runtime except skills",
+    matches: (target) => target.startsWith(".agents/") && !target.startsWith(".agents/skills/")
+  },
+  {
+    name: "skills",
+    description: ".agents/skills",
+    matches: (target) => target.startsWith(".agents/skills/")
+  },
+  {
+    name: "viewer",
+    description: ".delano viewer files",
+    matches: (target) => target.startsWith(".delano/")
+  },
+  {
+    name: "project-context",
+    description: ".project/context starter templates",
+    matches: (target) => target.startsWith(".project/context/")
+  },
+  {
+    name: "project-templates",
+    description: ".project/templates",
+    matches: (target) => target.startsWith(".project/templates/")
+  },
+  {
+    name: "project-registry",
+    description: ".project/registry",
+    matches: (target) => target.startsWith(".project/registry/")
+  },
+  {
+    name: "project-projects",
+    description: ".project/projects seed files",
+    matches: (target) => target.startsWith(".project/projects/")
+  },
+  {
+    name: "handbook",
+    description: "HANDBOOK.md",
+    matches: (target) => target === "HANDBOOK.md"
+  },
+  {
+    name: "legacy-installer",
+    description: "install-delano.sh",
+    matches: (target) => target === "install-delano.sh"
+  }
+];
+
+const INSTALL_CATEGORY_ALIASES = new Map([
+  ["agent-skills", "skills"],
+  ["agents", "agent-runtime"],
+  ["runtime", "agent-runtime"],
+  ["context", "project-context"],
+  ["templates", "project-templates"],
+  ["project-state", "project-projects"],
+  ["projects", "project-projects"],
+  ["registry", "project-registry"],
+  ["delano", "viewer"],
+  ["installer", "legacy-installer"]
+]);
+
+const INSTALL_CATEGORY_NAMES = INSTALL_CATEGORIES.map((category) => category.name);
+const PROJECT_STATE_CATEGORIES = ["project-context", "project-projects", "project-registry"];
+const INSTALL_PRESETS = [
+  {
+    id: "update-safe",
+    label: "Update Delano runtime, preserve project state",
+    description: "Refresh runtime files while excluding .project/context, .project/projects, and .project/registry.",
+    only: null,
+    exclude: PROJECT_STATE_CATEGORIES,
+    force: true
+  },
+  {
+    id: "skills-templates",
+    label: "Update skills and project templates",
+    description: "Refresh .agents/skills and .project/templates only.",
+    only: ["skills", "project-templates"],
+    exclude: [],
+    force: true
+  },
+  {
+    id: "full",
+    label: "Full install or repair",
+    description: "Install every allowlisted category. This includes project starter state.",
+    only: null,
+    exclude: [],
+    force: false
+  },
+  {
+    id: "custom",
+    label: "Choose categories",
+    description: "Pick exact categories and force behavior.",
+    only: null,
+    exclude: [],
+    force: false
+  }
+];
 
 function getMissingPackagedAssetMessage(relativePath) {
   return [
@@ -64,12 +161,47 @@ function parseAgentList(rawValue) {
   return selected;
 }
 
+function parseCategoryList(rawValue, optionName) {
+  if (!rawValue) {
+    throw new CliError(`Missing value for ${optionName}.`, 1);
+  }
+
+  const selected = [];
+  for (const chunk of rawValue.split(",")) {
+    const value = chunk.trim().toLowerCase();
+    if (!value) {
+      continue;
+    }
+
+    const categoryName = INSTALL_CATEGORY_ALIASES.get(value) || value;
+    if (!INSTALL_CATEGORY_NAMES.includes(categoryName)) {
+      throw new CliError(
+        `Unknown install category '${value}'. Supported values: ${INSTALL_CATEGORY_NAMES.join(", ")}.`,
+        1
+      );
+    }
+
+    if (!selected.includes(categoryName)) {
+      selected.push(categoryName);
+    }
+  }
+
+  if (selected.length === 0) {
+    throw new CliError(`No install categories selected for ${optionName}.`, 1);
+  }
+
+  return selected;
+}
+
 function parseInstallArgs(args) {
   const options = {
     target: process.cwd(),
     force: false,
     yes: false,
-    agents: [...SUPPORTED_AGENTS]
+    interactive: false,
+    agents: [...SUPPORTED_AGENTS],
+    only: null,
+    exclude: []
   };
 
   for (let index = 0; index < args.length; index += 1) {
@@ -103,6 +235,42 @@ function parseInstallArgs(args) {
       continue;
     }
 
+    if (arg === "--only") {
+      index += 1;
+      options.only = parseCategoryList(args[index], "--only");
+      continue;
+    }
+
+    if (arg.startsWith("--only=")) {
+      options.only = parseCategoryList(arg.slice("--only=".length), "--only");
+      continue;
+    }
+
+    if (arg === "--exclude") {
+      index += 1;
+      options.exclude = parseCategoryList(args[index], "--exclude");
+      continue;
+    }
+
+    if (arg.startsWith("--exclude=")) {
+      options.exclude = parseCategoryList(arg.slice("--exclude=".length), "--exclude");
+      continue;
+    }
+
+    if (arg === "--no-project-context") {
+      options.exclude = mergeCategoryLists(options.exclude, ["project-context"]);
+      continue;
+    }
+
+    if (arg === "--no-project-state") {
+      options.exclude = mergeCategoryLists(options.exclude, [
+        "project-context",
+        "project-projects",
+        "project-registry"
+      ]);
+      continue;
+    }
+
     if (arg === "--force") {
       options.force = true;
       continue;
@@ -113,6 +281,11 @@ function parseInstallArgs(args) {
       continue;
     }
 
+    if (arg === "--interactive" || arg === "--tui") {
+      options.interactive = true;
+      continue;
+    }
+
     throw new CliError(`Unknown install option: ${arg}`, 1);
   }
 
@@ -120,9 +293,170 @@ function parseInstallArgs(args) {
   return options;
 }
 
+function applyInstallPreset(options, presetId) {
+  const preset = INSTALL_PRESETS.find((candidate) => candidate.id === presetId);
+  if (!preset) {
+    throw new CliError(`Unknown install preset: ${presetId}`, 1);
+  }
+
+  return {
+    ...options,
+    only: preset.only ? [...preset.only] : null,
+    exclude: [...preset.exclude],
+    force: preset.force
+  };
+}
+
+async function configureInteractiveInstall(options) {
+  const prompt = createPrompter(stdin, stdout);
+  try {
+    console.log("Delano install");
+    console.log("==============");
+    console.log("");
+    console.log("Choose what to install:");
+    INSTALL_PRESETS.forEach((preset, index) => {
+      console.log(`  ${index + 1}. ${preset.label}`);
+      console.log(`     ${preset.description}`);
+    });
+    console.log("");
+
+    const presetAnswer = await prompt.ask("Selection [1]: ");
+    const presetIndex = parseSelectionNumber(presetAnswer, 1, INSTALL_PRESETS.length, 1) - 1;
+    const preset = INSTALL_PRESETS[presetIndex];
+    let configured = applyInstallPreset(options, preset.id);
+
+    const targetAnswer = await prompt.ask(`Target [${configured.target}]: `);
+    if (targetAnswer.trim()) {
+      configured.target = path.resolve(targetAnswer.trim());
+    }
+
+    if (preset.id === "custom") {
+      configured = await configureCustomInstallSelection(configured, prompt);
+    } else {
+      const forceDefault = configured.force ? "Y/n" : "y/N";
+      const forceAnswer = await prompt.ask(`Overwrite selected existing files with --force? [${forceDefault}] `);
+      configured.force = parseYesNo(forceAnswer, configured.force);
+    }
+
+    return configured;
+  } finally {
+    prompt.close();
+  }
+}
+
+async function configureCustomInstallSelection(options, prompt) {
+  console.log("");
+  console.log("Categories:");
+  INSTALL_CATEGORIES.forEach((category, index) => {
+    console.log(`  ${index + 1}. ${category.name} - ${category.description}`);
+  });
+  console.log("");
+  console.log("Enter category numbers or names separated by commas.");
+  console.log("Use 'all' for every category.");
+
+  const categoryAnswer = await prompt.ask("Categories [all]: ");
+  const only = parseInteractiveCategorySelection(categoryAnswer);
+  const forceAnswer = await prompt.ask("Overwrite selected existing files with --force? [y/N] ");
+
+  return {
+    ...options,
+    only,
+    exclude: [],
+    force: parseYesNo(forceAnswer, false)
+  };
+}
+
+function createPrompter(input, output) {
+  const rl = readline.createInterface({ input, crlfDelay: Infinity });
+  const iterator = rl[Symbol.asyncIterator]();
+
+  return {
+    async ask(promptText) {
+      output.write(promptText);
+      const next = await iterator.next();
+      const answer = next.done ? "" : next.value;
+      output.write("\n");
+      return answer;
+    },
+    close() {
+      rl.close();
+    }
+  };
+}
+
+
+function parseSelectionNumber(rawValue, min, max, defaultValue) {
+  const value = rawValue.trim();
+  if (!value) {
+    return defaultValue;
+  }
+
+  const parsed = Number(value);
+  if (!Number.isInteger(parsed) || parsed < min || parsed > max) {
+    throw new CliError(`Selection must be a number from ${min} to ${max}.`, 1);
+  }
+  return parsed;
+}
+
+function parseYesNo(rawValue, defaultValue) {
+  const value = rawValue.trim().toLowerCase();
+  if (!value) {
+    return defaultValue;
+  }
+  if (value === "y" || value === "yes") {
+    return true;
+  }
+  if (value === "n" || value === "no") {
+    return false;
+  }
+  throw new CliError("Answer must be yes or no.", 1);
+}
+
+function parseInteractiveCategorySelection(rawValue) {
+  const value = rawValue.trim();
+  if (!value || value.toLowerCase() === "all") {
+    return null;
+  }
+
+  const selected = [];
+  for (const chunk of value.split(",")) {
+    const token = chunk.trim();
+    if (!token) {
+      continue;
+    }
+
+    const numeric = Number(token);
+    const categoryName = Number.isInteger(numeric)
+      ? INSTALL_CATEGORIES[numeric - 1]?.name
+      : (INSTALL_CATEGORY_ALIASES.get(token.toLowerCase()) || token.toLowerCase());
+
+    if (!categoryName || !INSTALL_CATEGORY_NAMES.includes(categoryName)) {
+      throw new CliError(
+        `Unknown install category '${token}'. Supported values: ${INSTALL_CATEGORY_NAMES.join(", ")}.`,
+        1
+      );
+    }
+
+    if (!selected.includes(categoryName)) {
+      selected.push(categoryName);
+    }
+  }
+
+  if (selected.length === 0) {
+    throw new CliError("No install categories selected.", 1);
+  }
+
+  return selected;
+}
+
 function buildInstallPlan(options) {
   const { manifest, entries, payloadRoot } = readInstallManifest();
-  const items = entries.map((entry) => {
+  const selectedEntries = filterManifestEntries(entries, options);
+  if (selectedEntries.length === 0) {
+    throw new CliError("Install selection matched no files.", 1);
+  }
+
+  const items = selectedEntries.map((entry) => {
     const sourcePath = path.join(payloadRoot, entry.target);
     if (!existsSync(sourcePath)) {
       throw new CliError(getMissingPackagedAssetMessage(entry.target), 1);
@@ -137,11 +471,41 @@ function buildInstallPlan(options) {
 
   return {
     manifest,
+    selectedEntries,
+    skippedCount: entries.length - selectedEntries.length,
     items,
     targetRoot: options.target
   };
 }
 
+function mergeCategoryLists(left, right) {
+  const merged = [...left];
+  for (const item of right) {
+    if (!merged.includes(item)) {
+      merged.push(item);
+    }
+  }
+  return merged;
+}
+
+function getInstallCategory(target) {
+  const normalizedTarget = target.replace(/\\/g, "/");
+  return INSTALL_CATEGORIES.find((category) => category.matches(normalizedTarget))?.name || "uncategorized";
+}
+
+function filterManifestEntries(entries, options) {
+  const only = options.only ? new Set(options.only) : null;
+  const exclude = new Set(options.exclude || []);
+
+  return entries.filter((entry) => {
+    const category = getInstallCategory(entry.target);
+    if (only && !only.has(category)) {
+      return false;
+    }
+    return !exclude.has(category);
+  });
+}
+
 function collectConflicts(plan) {
   const conflicts = [];
 
@@ -191,10 +555,18 @@ function printPlanSummary(plan, options) {
   console.log("------------");
   console.log(`Target: ${options.target}`);
   console.log(`Files: ${plan.items.length}`);
+  if (plan.skippedCount > 0) {
+    console.log(`Skipped by selection: ${plan.skippedCount}`);
+  }
   console.log(`Agents: ${options.agents.join(", ")}`);
+  console.log(`Only: ${options.only ? options.only.join(", ") : "all categories"}`);
+  if (options.exclude.length > 0) {
+    console.log(`Exclude: ${options.exclude.join(", ")}`);
+  }
   console.log(`Force: ${options.force ? "yes" : "no"}`);
   console.log("");
   console.log("Note: --agents is accepted now for forward compatibility, but v1 base install still excludes top-level adapter entry docs by default.");
+  console.log("Note: .project/context, .project/projects, and .project/registry are repo-owned after install; use --no-project-state or --only for update-safe refreshes.");
 }
 
 function printConflicts(conflicts, options) {
@@ -211,7 +583,7 @@ function printConflicts(conflicts, options) {
   if (options.force) {
     console.error("Install cannot continue because at least one conflict is not forceable.");
   } else {
-    console.error("Install aborted before writing files. Re-run with --force to overwrite only allowlisted target paths.");
+    console.error("Install aborted before writing files. Re-run with --force to overwrite only selected allowlisted target paths, or narrow the plan with --only/--exclude.");
   }
 }
 
@@ -220,15 +592,15 @@ async function confirmInstall(plan, options) {
     return true;
   }
 
-  const rl = readline.createInterface({ input: stdin, output: stdout });
+  const prompt = createPrompter(stdin, stdout);
   try {
-    const prompt = options.force
+    const promptText = options.force
       ? `Proceed with force-installing ${plan.items.length} files into ${options.target}? [y/N] `
       : `Proceed with installing ${plan.items.length} files into ${options.target}? [y/N] `;
-    const answer = await rl.question(prompt);
+    const answer = await prompt.ask(promptText);
     return /^[Yy](es)?$/.test(answer.trim());
   } finally {
-    rl.close();
+    prompt.close();
   }
 }
 
@@ -294,12 +666,21 @@ function validateManifestPath(relativePath, fieldName) {
 }
 
 module.exports = {
+  INSTALL_CATEGORIES,
+  INSTALL_PRESETS,
   SUPPORTED_AGENTS,
   applyInstallPlan,
+  applyInstallPreset,
   buildInstallPlan,
   collectConflicts,
   confirmInstall,
+  configureInteractiveInstall,
+  createPrompter,
+  filterManifestEntries,
+  getInstallCategory,
   normalizeManifestEntries,
+  parseInteractiveCategorySelection,
+  parseCategoryList,
   parseAgentList,
   parseInstallArgs,
   printConflicts,