artifact-graph 0.3.0 → 0.3.1

package/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 ## Unreleased
 
+## 0.3.1
+
+### Fixed
+
+- **CLI help contract**: `artifact-graph --help`、`-h` 和 `help` now return exit code 0 and print usage to stdout, making `--help` a reliable install verification gate for public INSTALL instructions.
+- **init creates missing directories**: `artifact-graph init --root <path>` now creates intermediate directories if they don't exist, matching the documented usage pattern.
+
 ## 0.3.0
 
 ### Added

package/dist/cli.js

@@ -3,7 +3,7 @@
 // src/cli.ts
 import yaml2 from "js-yaml";
 import { realpathSync } from "fs";
-import { access as access2, readFile as readFile3, writeFile as writeFile5 } from "fs/promises";
+import { access as access2, mkdir as mkdir6, readFile as readFile3, writeFile as writeFile5 } from "fs/promises";
 import { join as join7 } from "path";
 import { fileURLToPath } from "url";
 
@@ -6134,6 +6134,10 @@ async function runCli(argv, io = {}) {
   const err = io.stderr ?? ((chunk) => process.stderr.write(chunk));
   const root = String(parsed.flags.root ?? cwd);
   try {
+    if (parsed.command === "--help" || parsed.command === "-h" || parsed.command === "help") {
+      out(helpText());
+      return 0;
+    }
     switch (parsed.command) {
       case "init": {
         await initConfig(root);
@@ -6983,6 +6987,7 @@ async function initConfig(root) {
       throw error;
     }
   }
+  await mkdir6(root, { recursive: true });
   await writeFile5(configPath, yaml2.dump(DEFAULT_SCHEMA, { lineWidth: 120 }));
 }
 function parseArgs(argv) {

package/package.json

@@ -1,10 +1,9 @@
 {
   "name": "artifact-graph",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "Git-native Markdown artifact graph scanner and validator",
   "license": "Apache-2.0",
   "type": "module",
-  "packageManager": "pnpm@10.17.1",
   "keywords": [
     "artifact-graph",
     "traceability",
@@ -33,16 +32,6 @@
   "engines": {
     "node": ">=22.0.0"
   },
-  "scripts": {
-    "build": "tsup src/index.ts --format esm,cjs --dts --splitting false && tsup src/cli.ts --format esm --dts --splitting false",
-    "test": "vitest run --config vitest.config.ts",
-    "test:ci": "ARTIFACT_GRAPH_PUBLIC_REPO=1 vitest run --config vitest.config.ts",
-    "test:watch": "vitest",
-    "typecheck": "tsc --noEmit",
-    "clean": "rm -rf dist coverage",
-    "packet:audit": "node scripts/run-packet-audit.mjs",
-    "packet:prompt-audit": "node scripts/run-packet-prompt-audit.mjs"
-  },
   "dependencies": {
     "better-sqlite3": "^11.9.0",
     "commander": "^13.1.0",
@@ -76,10 +65,15 @@
     "url": "https://github.com/mzdbxqh/artifact-graph/issues"
   },
   "homepage": "https://github.com/mzdbxqh/artifact-graph#readme",
-  "pnpm": {
-    "onlyBuiltDependencies": [
-      "better-sqlite3",
-      "esbuild"
-    ]
+  "scripts": {
+    "build": "tsup src/index.ts --format esm,cjs --dts --splitting false && tsup src/cli.ts --format esm --dts --splitting false",
+    "test": "vitest run --config vitest.config.ts",
+    "test:ci": "ARTIFACT_GRAPH_PUBLIC_REPO=1 vitest run --config vitest.config.ts && pnpm test:npm-consumer",
+    "test:npm-consumer": "node test/npm-bin-install.test.mjs",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist coverage",
+    "packet:audit": "node scripts/run-packet-audit.mjs",
+    "packet:prompt-audit": "node scripts/run-packet-prompt-audit.mjs"
   }
-}
+}