create-quiver 0.8.0 → 0.9.1

package/specs/quiver-v19-self-install-dev-dep/slices/slice-01-auto-install-dev-dep/slice.json

@@ -0,0 +1,56 @@
+{
+  "slice_id": "slice-01-auto-install-dev-dep",
+  "ticket": "QUIVER-01",
+  "type": "feature",
+  "title": "Auto-install create-quiver as dev dependency after init/migrate",
+  "objective": "After `npx create-quiver` init or migrate, the target project has create-quiver in devDependencies and installed in node_modules. Uses the correct package manager. Skippable via --skip-install.",
+  "description": "Add two functions to init-docs.js: detectPackageManager (checks lockfiles) and installSelfAsDevDep (runs the appropriate install command). Call installSelfAsDevDep from the init and migrate flows in index.js after runInitDocs. Add --skip-install flag to the CLI arg parser.",
+  "git": {
+    "branch_type": "feature",
+    "base_branch": "main",
+    "branch_slug": "auto-install-dev-dep",
+    "branch_name": "feature/QUIVER-01-auto-install-dev-dep"
+  },
+  "files": [
+    "src/create-quiver/lib/init-docs.js",
+    "src/create-quiver/index.js",
+    "tests/lib/init-docs.test.js"
+  ],
+  "depends_on": [],
+  "must": [
+    "detectPackageManager(projectRoot) returns 'bun'|'pnpm'|'yarn'|'npm' based on lockfile presence",
+    "installSelfAsDevDep(projectRoot, version) runs the correct install command for the detected pm",
+    "installSelfAsDevDep skips if no package.json exists (returns 'skipped-no-package-json')",
+    "installSelfAsDevDep skips if create-quiver already in devDependencies (returns 'skipped-already-present')",
+    "installSelfAsDevDep catches install errors and returns 'failed' without throwing",
+    "--skip-install flag parsed in index.js and passed through to suppress the install step",
+    "Both init and migrate flows call installSelfAsDevDep unless --skip-install is set",
+    "Init output prints 'Added create-quiver@X.Y.Z as dev dependency' on success or a warning on skip/fail",
+    "node --test tests/**/*.test.js passes"
+  ],
+  "not_included": [
+    "Auto-updating an existing create-quiver version in devDependencies",
+    "Supporting private registries or custom npm configs",
+    "Changing the scaffold output beyond the install step message"
+  ],
+  "acceptance": [
+    "After init: package.json has create-quiver in devDependencies",
+    "After init: node_modules/create-quiver exists",
+    "npx create-quiver plan works without @version in a freshly initialized project",
+    "--skip-install suppresses the install in both init and migrate",
+    "yarn/pnpm/bun projects use the right install command",
+    "Install failure prints a warning but does not crash the init",
+    "node --test tests/**/*.test.js exits 0"
+  ],
+  "tests": [
+    "node --test tests/**/*.test.js",
+    "npx create-quiver --skip-install --name test --dir /tmp/quiver-test-skip && ls /tmp/quiver-test-skip/node_modules/create-quiver 2>/dev/null && echo FAIL || echo OK"
+  ],
+  "estimated_hours": 1.5,
+  "actual_hours": 1,
+  "status": "completed",
+  "blocked_reason": null,
+  "ready_at": "2026-05-14T00:00:00Z",
+  "started_at": "2026-05-14T00:00:00Z",
+  "completed_at": "2026-05-14T00:00:00Z"
+}

package/src/create-quiver/index.js

@@ -7,7 +7,7 @@ const { collectDoctorWarnings } = require('./lib/doctor');
 const { runGraph } = require('./commands/graph');
 const { runNext } = require('./commands/next');
 const { runPlan } = require('./commands/plan');
-const { initializeProjectDocs } = require('./lib/init-docs');
+const { initializeProjectDocs, installSelfAsDevDep } = require('./lib/init-docs');
 const { checkPrReadiness, checkScope, checkSliceReadiness } = require('./lib/readiness');
 const { cleanupSlice, refreshActiveSlicesBoard, startSlice } = require('./lib/lifecycle');
 const { relativePosixPath, resolveTargetRoot } = require('./lib/paths');
@@ -144,6 +144,11 @@ function parseArgs(argv) {
       continue;
     }
 
+    if (arg === '--skip-install') {
+      result.skipInstall = true;
+      continue;
+    }
+
     if (arg === '--doctor') {
       result.mode = 'doctor';
       continue;
@@ -1133,7 +1138,7 @@ function runAnalyze(targetDir) {
   console.log(`Detected package manager: ${scan.project.package_manager}`);
 }
 
-function runMigrate(targetDir) {
+function runMigrate(targetDir, options = {}) {
   const projectRoot = resolveTargetRoot(process.cwd(), targetDir);
 
   if (!fs.existsSync(projectRoot)) {
@@ -1160,6 +1165,15 @@ function runMigrate(targetDir) {
     });
     updateStateForMigrate(projectRoot, projectName, CLI_VERSION);
 
+    if (!options.skipInstall) {
+      const installResult = installSelfAsDevDep(projectRoot, CLI_VERSION);
+      if (installResult === 'installed') {
+        console.log(`Added create-quiver@${CLI_VERSION} as dev dependency`);
+      } else if (installResult === 'failed') {
+        console.warn(`Warning: could not install create-quiver automatically. Run: npm install -D create-quiver@${CLI_VERSION}`);
+      }
+    }
+
     console.log(`Quiver migration completed for ${projectRoot}`);
     console.log('Missing workflow files were restored without overwriting existing project files.');
   } finally {
@@ -1336,7 +1350,7 @@ async function run(argv) {
   }
 
   if (args.mode === 'migrate') {
-    runMigrate(args.targetDir);
+    runMigrate(args.targetDir, { skipInstall: args.skipInstall });
     return;
   }
 
@@ -1415,6 +1429,15 @@ async function run(argv) {
     copyTemplate(templateRoot, targetDir);
     runInitDocs(targetDir, projectName);
 
+    if (!args.skipInstall) {
+      const installResult = installSelfAsDevDep(targetDir, CLI_VERSION);
+      if (installResult === 'installed') {
+        console.log(`Added create-quiver@${CLI_VERSION} as dev dependency`);
+      } else if (installResult === 'failed') {
+        console.warn(`Warning: could not install create-quiver automatically. Run: npm install -D create-quiver@${CLI_VERSION}`);
+      }
+    }
+
     console.log(`Installed Quiver into ${targetDir}`);
     printInitNextSteps(targetDir, projectName);
   } finally {

package/src/create-quiver/lib/init-docs.js

@@ -1,5 +1,6 @@
 const fs = require('fs');
 const path = require('path');
+const { execSync } = require('child_process');
 const { writeState } = require('./state');
 
 function ensureDir(dirPath) {
@@ -334,9 +335,15 @@ Read \`AGENTS.md\` first, then open \`docs/AI_ONBOARDING_PROMPT.md\` after analy
 After analysis and doctor validation, open your AI agent in this project and run:
 
 \`\`\`text
-Read docs/AI_ONBOARDING_PROMPT.md and execute it.
-Do not modify product code unless I explicitly authorize it.
-Prepare the project context docs and report assumptions, risks, and files changed.
+Lee \`docs/AI_ONBOARDING_PROMPT.md\` y ejecútalo como fuente principal de verdad para incorporarte a este repositorio.
+
+Actúa como asistente de onboarding de IA. Prepara el contexto del proyecto para trabajar de forma segura con el workflow documentado, specs y slices.
+
+No modifiques código de producto salvo autorización explícita. Puedes crear o actualizar documentación de contexto si el onboarding lo requiere.
+
+Usa solo la documentación del repositorio como fuente de verdad. Si encuentras información faltante, ambigua o contradictoria, documenta el supuesto, el riesgo y continúa por el camino más seguro.
+
+Responde en español y finaliza con un reporte breve de archivos leídos, archivos modificados, estado del código de producto, supuestos, riesgos y próximos pasos.
 \`\`\`
 
 Review the AI changes to docs/AI_CONTEXT.md, docs/CONTEXTO.md, docs/STATUS.md, and specs/${projectSlug}/SPEC.md before starting implementation work. Use \`docs/PROJECT_MAP.md\` for stack and command details.
@@ -667,8 +674,44 @@ function initializeProjectDocs(options) {
   };
 }
 
+function detectPackageManager(projectRoot) {
+  if (fs.existsSync(path.join(projectRoot, 'bun.lockb'))) return 'bun';
+  if (fs.existsSync(path.join(projectRoot, 'pnpm-lock.yaml'))) return 'pnpm';
+  if (fs.existsSync(path.join(projectRoot, 'yarn.lock'))) return 'yarn';
+  return 'npm';
+}
+
+function installSelfAsDevDep(projectRoot, version) {
+  const packageJsonPath = path.join(projectRoot, 'package.json');
+  if (!fs.existsSync(packageJsonPath)) {
+    return 'skipped-no-package-json';
+  }
+
+  const pkg = JSON.parse(fs.readFileSync(packageJsonPath, 'utf8'));
+  if (pkg.devDependencies && pkg.devDependencies['create-quiver']) {
+    return 'skipped-already-present';
+  }
+
+  const pm = detectPackageManager(projectRoot);
+  const commands = {
+    npm: `npm install -D create-quiver@${version}`,
+    yarn: `yarn add -D create-quiver@${version}`,
+    pnpm: `pnpm add -D create-quiver@${version}`,
+    bun: `bun add -d create-quiver@${version}`,
+  };
+
+  try {
+    execSync(commands[pm], { cwd: projectRoot, stdio: 'inherit' });
+    return 'installed';
+  } catch {
+    return 'failed';
+  }
+}
+
 module.exports = {
   initializeProjectDocs,
   writeFrontMatter,
   toProjectSlug,
+  detectPackageManager,
+  installSelfAsDevDep,
 };

package/.claude/settings.local.json

@@ -1,45 +0,0 @@
-{
-  "permissions": {
-    "allow": [
-      "Bash(git fetch *)",
-      "Bash(git checkout *)",
-      "Bash(git add *)",
-      "Bash(git commit -m ' *)",
-      "Bash(git cherry-pick *)",
-      "Bash(git reset *)",
-      "Bash(gh pr create --title 'docs: register v17-v22 orchestration plan and park web console idea' --base main --head docs/register-orchestration-plan-park-web-console --body ' *)",
-      "Bash(gh auth *)",
-      "Bash(gh pr *)",
-      "Bash(node -e \"const g=require\\('./src/create-quiver/lib/slice-graph'\\); const slices=g.readAllSlices\\('.'\\); console.log\\('Total slices:', slices.length\\); const graph=g.buildGraph\\(slices\\); const levels=g.computeLevels\\(graph\\); console.log\\('Levels:', levels.length\\);\")",
-      "Bash(npx . plan)",
-      "Bash(git pull *)",
-      "Read(//Users/fabrijk/Documents/Work/Proyectos Personales/nika/frameworks/.worktrees/quiver/bugfix-QUIVER-01-fix-legacy-dependency-resolution/**)",
-      "Bash(node --test tests/)",
-      "Bash(node --test tests/**/*.test.js)",
-      "Bash(node bin/create-quiver.js plan)",
-      "Bash(echo \"EXIT_$?\")",
-      "Bash(node bin/create-quiver.js plan --json)",
-      "Bash(node -e \"const d=JSON.parse\\(require\\('fs'\\).readFileSync\\('/dev/stdin','utf8'\\)\\); console.log\\('plan items:', Array.isArray\\(d.plan\\) ? d.plan.length : 'NOT ARRAY'\\); console.log\\('critical_path:', Array.isArray\\(d.critical_path\\)\\); console.log\\('total_hours:', typeof d.total_hours\\); process.exit\\(Array.isArray\\(d.plan\\) && Array.isArray\\(d.critical_path\\) && typeof d.total_hours === 'number' ? 0 : 1\\)\")",
-      "Bash(grep -v \"^\\\\-\\\\-$\")",
-      "Bash(echo \"EXIT:$?\")",
-      "Bash(node -e \"const d=JSON.parse\\(require\\('fs'\\).readFileSync\\('/tmp/plan_json.txt','utf8'\\)\\); console.log\\('plan:', Array.isArray\\(d.plan\\) ? d.plan.length + ' items' : 'INVALID'\\); console.log\\('critical_path:', Array.isArray\\(d.critical_path\\)\\); console.log\\('total_hours:', typeof d.total_hours\\)\")",
-      "Bash(xargs git branch -d)",
-      "Bash(git branch *)",
-      "Read(//private/tmp/**)",
-      "Read(//Users/fabrijk/Documents/Work/Proyectos Personales/nika/frameworks/quiver-v18-slice02/**)",
-      "Bash(git worktree *)",
-      "Bash(git ls-remote *)",
-      "Bash(node *)",
-      "Bash(npm view *)",
-      "Bash(bash scripts/release-quiver.sh)",
-      "Bash(git stash *)",
-      "Bash(npm whoami *)",
-      "Bash(bash scripts/release-quiver.sh --publish-current)",
-      "Bash(npm pkg *)",
-      "Bash(NPM_TOKEN=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 npm publish --access public)",
-      "Bash(NPM_TOKEN=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 npm publish --access public)",
-      "Bash(npm info *)",
-      "Bash(npm publish *)"
-    ]
-  }
-}