@bvdm/delano 0.1.1 → 0.1.3

package/README.md

@@ -46,6 +46,42 @@ delano --yes
 delano --target /path/to/repo --yes
 ```
 
+## Global CLI install
+
+If you want `delano` available in every repository you work in, install it globally:
+
+```bash
+npm install -g @bvdm/delano
+```
+
+Typical flow in a repository:
+
+```bash
+cd /path/to/repo
+delano install --yes
+delano validate
+delano init <slug> "<Project Name>" [owner] [lead]
+```
+
+Command intent:
+
+- `delano install` bootstraps the Delano runtime into the current repository
+- `delano validate` checks whether the runtime and required assets are in place
+- `delano init` creates a delivery project inside a repository that already has Delano installed
+
+`delano init` usage:
+
+```bash
+delano init <slug> "<Project Name>" [owner] [lead]
+```
+
+Notes:
+
+- use kebab-case for `<slug>`
+- `owner` defaults to `team`
+- `lead` defaults to `owner`
+- this is the right command for an agent to scaffold a new delivery project after `delano install`
+
 ## How to use Delano after install
 
 If you bootstrap with one-shot `npx`, keep using `npx` for wrapper commands:
@@ -62,7 +98,7 @@ If the package is installed locally or globally, run these inside the target rep
 delano validate
 delano status
 delano next -- --all
-delano init <slug> "<Project Name>" <owner> <lead>
+delano init <slug> "<Project Name>" [owner] [lead]
 ```
 
 The wrapper commands call the existing PM scripts under `.agents/scripts/pm/`. You can also run those scripts directly:
@@ -93,9 +129,31 @@ The CLI does not bundle its own shell or Python runtime.
 - it reports each conflict as file, directory, or symlink
 - it only overwrites approved allowlist paths when `--force` is used
 - it does not touch unrelated files outside the allowlist
+- it does not install or overwrite repo-root Git config files such as `.gitignore` or `.gitattributes`
 
 The base install payload intentionally excludes top-level adapter entry docs such as `AGENTS.md`, `CLAUDE.md`, `CODEX.md`, `OPENCODE.md`, and `PI.md`. Those remain opt-in only.
 
+## Optional AGENTS.md / CLAUDE.md snippet
+
+If you want explicit Delano instructions in a repo-root `AGENTS.md` or `CLAUDE.md`, copy and paste this yourself:
+
+```md
+## Delano
+
+This repository uses Delano.
+
+Canonical process and contracts live in `HANDBOOK.md`.
+Delivery state lives in `.project/`.
+Shared runtime lives in `.agents/`.
+`.claude/` is a compatibility mirror of `.agents/`, not a second runtime.
+
+When working in this repository:
+- treat `.project/` as the source of truth
+- use the Delano status model and evidence discipline from `HANDBOOK.md`
+- keep sync and quality gates aligned with the handbook
+- use `delano init <slug> "<Project Name>" [owner] [lead]` to scaffold a new delivery project when needed
+```
+
 ## v1.1 boundaries
 
 This package is deliberately narrow:

package/assets/install-manifest.json

@@ -75,8 +75,6 @@
     ".agents/skills/sync-skill/templates/conflict-resolution-actions.md",
     ".agents/skills/sync-skill/templates/drift-report.md",
     ".delano/README.md",
-    ".gitattributes",
-    ".gitignore",
     ".project/context/gui-testing.md",
     ".project/context/product-context.md",
     ".project/context/progress.md",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bvdm/delano",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Thin npm CLI for the Delano delivery runtime.",
   "license": "UNLICENSED",
   "bin": {

package/src/cli/lib/install.js

@@ -11,7 +11,6 @@ const path = require("node:path");
 const readline = require("node:readline/promises");
 const { stdin, stdout } = require("node:process");
 
-const { getPackagedAssetRelativePath } = require("./asset-paths");
 const { CliError } = require("./errors");
 const { getPackageRoot, getPathType } = require("./runtime");
 
@@ -123,7 +122,7 @@ function parseInstallArgs(args) {
 function buildInstallPlan(options) {
   const { manifest, payloadRoot } = readInstallManifest();
   const items = manifest.paths.map((relativePath) => {
-    const sourcePath = path.join(payloadRoot, getPackagedAssetRelativePath(relativePath));
+    const sourcePath = path.join(payloadRoot, relativePath);
     if (!existsSync(sourcePath)) {
       throw new CliError(getMissingPackagedAssetMessage(relativePath), 1);
     }

package/assets/payload/.gitattributes

@@ -1,14 +0,0 @@
-*.sh text eol=lf
-*.bash text eol=lf
-*.zsh text eol=lf
-
-*.md text eol=lf
-*.yml text eol=lf
-*.yaml text eol=lf
-*.json text eol=lf
-*.jsonc text eol=lf
-*.ts text eol=lf
-*.tsx text eol=lf
-*.js text eol=lf
-*.mjs text eol=lf
-*.py text eol=lf

package/assets/payload/__dot_gitignore__

@@ -1,20 +0,0 @@
-# Runtime local artifacts
-.claude/logs/*.jsonl
-.claude/logs/tests/
-.agents/logs/*.jsonl
-.agents/logs/tests/
-
-# Keep structural markers and docs
-!.claude/logs/.gitkeep
-!.claude/logs/schema.md
-!.agents/logs/.gitkeep
-!.agents/logs/schema.md
-
-# Local Claude overrides
-.claude/settings.local.json
-.agents/settings.local.json
-
-# Node/npm local artifacts
-node_modules/
-assets/payload/
-*.tgz

package/src/cli/lib/asset-paths.js

@@ -1,21 +0,0 @@
-const path = require("node:path");
-
-const PACKAGED_BASENAME_MAP = new Map([
-  [".gitignore", "__dot_gitignore__"]
-]);
-
-function getPackagedAssetRelativePath(relativePath) {
-  const normalizedPath = relativePath.split(/[\\/]/).join("/");
-  const parsedPath = path.posix.parse(normalizedPath);
-  const packagedBasename = PACKAGED_BASENAME_MAP.get(parsedPath.base);
-
-  if (!packagedBasename) {
-    return normalizedPath;
-  }
-
-  return parsedPath.dir ? `${parsedPath.dir}/${packagedBasename}` : packagedBasename;
-}
-
-module.exports = {
-  getPackagedAssetRelativePath
-};