@vodmal/vdx-cli 0.9.1 → 0.11.0

package/README.md

@@ -36,10 +36,10 @@ sub-optimal.
 vdx up | down | build | test | check | fix
 
 # Maturity audit against the owner baseline rubric
-vdx audit <project-path> [--format=ansi|markdown|json] [--rubric <path>] [--stack <id>]
+vdx audit [project-path] [--format=ansi|markdown|json] [--rubric <path>] [--stack <id>]   # default: cwd
 
-# Generate mise.toml + AGENTS.md for a project
-vdx init  <project-path> [--baseline github.com/org/repo@vX.Y] [--stack <id>] [--dry-run] [--force]
+# Generate mise.toml for a project (no AGENTS.md — vdx-discover skill covers Claude Code; pick your own format for other agents)
+vdx init  [project-path] [--baseline github.com/org/repo@vX.Y] [--stack <id>] [--dry-run] [--force]   # default: cwd
 
 # Publish a library (Node MVP; PHP/Python coming in Y.3)
 vdx publish <patch|minor|major> [--dry-run] [--force]
@@ -54,11 +54,11 @@ vdx-mcp   --project <path>
 **Three quick examples**
 
 ```bash
-# 1. Score the project I'm standing in
-vdx audit .
+# 1. Score the project I'm standing in (no arg → cwd)
+vdx audit
 
 # 2. Wire native scripts into the 6 lifecycle verbs, then run one
-vdx init . --stack node
+vdx init --stack node
 vdx test            # → mise run test (which calls `vitest run` or whatever was detected)
 
 # 3. Ship a new minor release of a Node lib
@@ -89,7 +89,7 @@ npm run typecheck
 - `src/evaluator.ts`  — recursive evaluator + sugar notation
 - `src/scoring.ts`    — delta-style levels, flags for orthogonal axes
 - `src/audit.ts`      — orchestrator: overrides + applies_to filter + subpackage-ctx
-- `src/init.ts`       — `vdx init` planner (`selectVerbTask` + mise.toml/AGENTS.md renderers)
+- `src/init.ts`       — `vdx init` planner (`selectVerbTask` + mise.toml renderer)
 - `src/run.ts`        — `resolveLifecycleVerb` + error renderer (pure logic for `vdx <verb>`)
 - `src/publish.ts`    — `planPublish` (pre-flight) + `executePublish` (bump → npm → git)
 - `src/report.ts`     — markdown / JSON output

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vodmal/vdx-cli",
-  "version": "0.9.1",
+  "version": "0.11.0",
   "description": "vdx — unified lifecycle interface (up/down/build/test/check/fix) + versioned maturity audit with drift detection. Pairs with the vdx Claude Code plugin.",
   "keywords": [
     "vdx",

package/src/index.ts

@@ -36,8 +36,8 @@ function usage(): never {
   process.stderr.write(
     `Usage:
   vdx <up|down|build|test|check|fix>     run lifecycle verb (via mise run <verb>)
-  vdx audit   <project_path> [--rubric <path>] [--stack <stack>] [--format=ansi|markdown|json] [--json]
-  vdx init    <project_path> [--stack <id>] [--baseline <ref>] [--dry-run] [--force]
+  vdx audit   [project_path]  [--rubric <path>] [--stack <stack>] [--format=ansi|markdown|json] [--json]   (default: cwd)
+  vdx init    [project_path]  [--stack <id>] [--baseline <ref>] [--dry-run] [--force]                     (default: cwd)
   vdx publish <patch|minor|major> [--dry-run] [--force]
   vdx doctor  [--format=ansi|markdown|json] [--json]
 `,
@@ -80,8 +80,7 @@ function parseArgs(argv: string[]): ParsedArgs {
 }
 
 function cmdAudit(opts: ParsedArgs): void {
-  const projectArg = opts.positionals[0];
-  if (!projectArg) usage();
+  const projectArg = opts.positionals[0] ?? '.';
   const projectRoot = path.resolve(projectArg);
 
   if (!looksLikeProject(projectRoot)) {
@@ -129,8 +128,7 @@ function cmdAudit(opts: ParsedArgs): void {
 }
 
 function cmdInit(opts: ParsedArgs): void {
-  const projectArg = opts.positionals[0];
-  if (!projectArg) usage();
+  const projectArg = opts.positionals[0] ?? '.';
   const projectRoot = path.resolve(projectArg);
 
   const baselineFlag = opts.flags.baseline;
@@ -142,21 +140,20 @@ function cmdInit(opts: ParsedArgs): void {
     ...(stackOverride ? { stack: stackOverride } : {}),
   });
 
-  process.stdout.write(renderPlanSummary(plan));
+  const dryRun = Boolean(opts.flags['dry-run']);
+  process.stdout.write(renderPlanSummary(plan, { verbose: dryRun }));
 
   for (const w of plan.warnings) {
     process.stderr.write(`\n⚠ ${w}\n`);
   }
 
-  if (opts.flags['dry-run']) {
-    process.stderr.write('\n[dry-run] mise.toml / AGENTS.md не записаны.\n');
+  if (dryRun) {
+    process.stderr.write('\n[dry-run] mise.toml не записан.\n');
     return;
   }
   try {
     writeInit(plan, { force: Boolean(opts.flags.force) });
-    process.stderr.write(
-      `\n✓ Записаны:\n  ${plan.miseTomlPath}\n  ${plan.agentsMdPath}\n`,
-    );
+    process.stderr.write(`\n✓ wrote ${plan.miseTomlPath}\n`);
   } catch (e: any) {
     process.stderr.write(`\nerror: ${e?.message ?? String(e)}\n`);
     process.exit(2);

package/src/init.ts

@@ -2,9 +2,7 @@ import * as fs from 'node:fs';
 import * as path from 'node:path';
 import {
   Ctx,
-  fileExists,
   readJson,
-  readText,
   listAllTasks,
   autoDetectStack,
   findSubPackages,
@@ -124,8 +122,6 @@ export interface InitPlan {
   mappings: VerbMapping[];
   miseTomlPath: string;
   miseTomlContent: string;
-  agentsMdPath: string;
-  agentsMdContent: string;
   baseline: string;
   /** Human-readable advisories for the user — printed to stderr by the CLI. */
   warnings: string[];
@@ -299,7 +295,7 @@ export function renderMiseToml(
         stack +
         '". Замени на php/node/go/python/meta',
     );
-    out.push('#   и заполни [tasks.*] блоки руками, либо перегенери: vdx init . --stack <id>.');
+    out.push('#   и заполни [tasks.*] блоки руками, либо перегенери: vdx init --stack <id>.');
     out.push('');
   }
 
@@ -340,52 +336,6 @@ export function renderMiseToml(
   return out.join('\n');
 }
 
-const AGENTS_MARKER_OPEN = '<!-- vdx:commands -->';
-const AGENTS_MARKER_CLOSE = '<!-- /vdx:commands -->';
-
-export function renderAgentsCommandsSection(
-  mappings: VerbMapping[],
-  baseline: string,
-): string {
-  const lines: string[] = [];
-  lines.push(AGENTS_MARKER_OPEN);
-  lines.push('## Commands');
-  lines.push('');
-  lines.push(
-    `This project follows the vdx lifecycle interface (baseline: ${baseline}).`,
-  );
-  lines.push('');
-  lines.push('| Verb | What it does | Native command |');
-  lines.push('|------|--------------|----------------|');
-  for (const m of mappings) {
-    if (!m.runCommand) {
-      lines.push(`| \`mise run ${m.verb}\` | ${VERB_DESCRIPTIONS[m.verb]} | _(not mapped)_ |`);
-    } else {
-      lines.push(
-        `| \`mise run ${m.verb}\` | ${VERB_DESCRIPTIONS[m.verb]} | \`${m.runCommand}\` |`,
-      );
-    }
-  }
-  lines.push(AGENTS_MARKER_CLOSE);
-  return lines.join('\n');
-}
-
-export function buildAgentsMd(existing: string | null, section: string): string {
-  if (existing === null) {
-    return `# AGENTS\n\nProject agent guide.\n\n${section}\n`;
-  }
-  const openIdx = existing.indexOf(AGENTS_MARKER_OPEN);
-  const closeIdx = existing.indexOf(AGENTS_MARKER_CLOSE);
-  if (openIdx !== -1 && closeIdx !== -1 && closeIdx > openIdx) {
-    const before = existing.slice(0, openIdx);
-    const after = existing.slice(closeIdx + AGENTS_MARKER_CLOSE.length);
-    return before + section + after;
-  }
-  // No markers — append.
-  const sep = existing.endsWith('\n') ? '\n' : '\n\n';
-  return existing + sep + section + '\n';
-}
-
 export function planInit(
   projectRoot: string,
   opts: { baseline?: string; stack?: string } = {},
@@ -463,11 +413,6 @@ export function planInit(
   const baseline = opts.baseline ?? DEFAULT_BASELINE;
   const miseTomlContent = renderMiseToml(tools, mappings, stack, baseline, primarySubpackage);
 
-  const agentsMdPath = path.join(projectRoot, 'AGENTS.md');
-  const existingAgents = fileExists(rootCtx, 'AGENTS.md') ? readText(rootCtx, 'AGENTS.md') : null;
-  const section = renderAgentsCommandsSection(mappings, baseline);
-  const agentsMdContent = buildAgentsMd(existingAgents, section);
-
   let pkgManager: InitPlan['pkgManager'] = null;
   const pmStack = primarySubpackage ? scanStack : stack;
   const pmRoot = primarySubpackage ? scanRoot : projectRoot;
@@ -484,8 +429,6 @@ export function planInit(
     mappings,
     miseTomlPath: path.join(projectRoot, 'mise.toml'),
     miseTomlContent,
-    agentsMdPath,
-    agentsMdContent,
     baseline,
     warnings,
   };
@@ -498,10 +441,24 @@ export function writeInit(plan: InitPlan, opts: { force: boolean }): void {
     );
   }
   fs.writeFileSync(plan.miseTomlPath, plan.miseTomlContent, 'utf8');
-  fs.writeFileSync(plan.agentsMdPath, plan.agentsMdContent, 'utf8');
 }
 
-export function renderPlanSummary(plan: InitPlan): string {
+export function renderPlanSummary(plan: InitPlan, opts: { verbose?: boolean } = {}): string {
+  const verbose = opts.verbose === true;
+  const mapped = plan.mappings.filter((m) => m.runCommand).length;
+  const total = plan.mappings.length;
+  const unmatched = plan.mappings.filter((m) => !m.runCommand).map((m) => m.verb);
+
+  if (!verbose) {
+    const lines: string[] = [];
+    lines.push(`vdx init: stack=${plan.stack}${plan.stackOverridden ? ' (via --stack)' : ''}, ${mapped}/${total} verbs mapped`);
+    if (plan.primarySubpackage) lines.push(`  primary subpackage: ${plan.primarySubpackage}`);
+    if (unmatched.length > 0) {
+      lines.push(`  not mapped: ${unmatched.join(', ')} (add [tasks.X] in mise.toml manually)`);
+    }
+    return lines.join('\n') + '\n';
+  }
+
   const lines: string[] = [];
   lines.push(`# vdx init plan`);
   lines.push('');
@@ -555,7 +512,6 @@ export function renderPlanSummary(plan: InitPlan): string {
     }
     lines.push('');
   }
-  const unmatched = plan.mappings.filter((m) => !m.runCommand).map((m) => m.verb);
   if (unmatched.length > 0) {
     lines.push(`> Not mapped: ${unmatched.join(', ')}. Добавь тиски в \`mise.toml\` вручную.`);
     lines.push('');

package/src/run.ts

@@ -43,14 +43,14 @@ export function renderResolveError(
     case 'no-mise-toml':
       return (
         `vdx: no mise.toml in ${projectRoot}\n` +
-        `hint: run \`vdx init .\` to generate one, or define it manually.\n`
+        `hint: run \`vdx init\` to generate one, or define it manually.\n`
       );
     case 'parse-error':
       return `vdx: failed to parse mise.toml: ${res.detail ?? 'unknown error'}\n`;
     case 'no-task':
       return (
         `vdx: no \`[tasks.${verb}]\` in mise.toml\n` +
-        `hint: run \`vdx init . --force\` to re-detect, or add the task manually.\n`
+        `hint: run \`vdx init --force\` to re-detect, or add the task manually.\n`
       );
   }
 }