@outcomeeng/spx 0.3.1 → 0.4.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@outcomeeng/spx",
-  "version": "0.3.1",
+  "version": "0.4.0",
   "description": "Developer CLI for code validation and session management",
   "type": "module",
   "bin": {
@@ -51,8 +51,8 @@
     "publish:check": "pnpm run validate && pnpm run build && vitest run && pnpm run validate:published",
     "knip": "tsx src/cli.ts validation knip",
     "circular": "tsx src/cli.ts validation circular",
-    "format": "prettier --write .",
-    "format:check": "prettier --check .",
+    "format": "dprint fmt .",
+    "format:check": "dprint check .",
     "prepare": "lefthook install",
     "prepublishOnly": "pnpm run publish:check"
   },
@@ -65,41 +65,46 @@
   "author": "Outcome Engineering",
   "license": "MIT",
   "devDependencies": {
-    "@faker-js/faker": "^10.2.0",
-    "@types/eslint-config-prettier": "^6.11.3",
+    "@faker-js/faker": "^10.4.0",
     "@types/estree": "^1.0.8",
     "@types/madge": "^5.0.3",
-    "@types/node": "^20.10.0",
-    "@vitest/coverage-v8": "^4.0.18",
-    "eslint": "^9.39.2",
-    "eslint-config-prettier": "^10.1.8",
+    "@types/node": "^20.19.39",
+    "@vitest/coverage-v8": "^4.1.5",
+    "eslint": "^9.39.4",
     "eslint-plugin-import": "^2.32.0",
-    "fast-check": "^4.5.3",
-    "globals": "^17.0.0",
-    "husky": "^9.1.7",
+    "fast-check": "^4.7.0",
+    "globals": "^17.5.0",
     "jsonc-parser": "^3.3.1",
-    "knip": "^5.80.0",
-    "lefthook": "^1.10.10",
-    "prettier": "^3.7.4",
-    "tsup": "^8.0.1",
+    "knip": "^5.88.1",
+    "lefthook": "^1.13.6",
+    "tsup": "^8.5.1",
     "tsx": "^4.21.0",
-    "typescript": "^5.3.3",
-    "typescript-eslint": "^8.51.0",
-    "vitest": "^4.0.18"
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.59.1",
+    "vitest": "^4.1.5"
   },
   "dependencies": {
-    "@typescript-eslint/parser": "^8.59.0",
-    "@typescript-eslint/visitor-keys": "^8.59.0",
+    "@typescript-eslint/parser": "^8.59.1",
+    "@typescript-eslint/visitor-keys": "^8.59.1",
     "chalk": "^5.6.2",
     "commander": "^11.1.0",
     "eslint-visitor-keys": "^5.0.1",
     "execa": "^9.6.1",
     "fast-xml-parser": "^5.7.2",
     "madge": "^8.0.0",
-    "markdownlint-cli2": "^0.22.0",
+    "markdownlint-cli2": "^0.22.1",
     "markdownlint-rule-relative-links": "^5.1.0",
     "smol-toml": "^1.6.1",
-    "yaml": "^2.8.2"
+    "yaml": "^2.8.3"
   },
-  "packageManager": "pnpm@10.33.0+sha512.10568bb4a6afb58c9eb3630da90cc9516417abebd3fabbe6739f0ae795728da1491e9db5a544c76ad8eb7570f5c4bb3d6c637b2cb41bfdcdb47fa823c8649319"
+  "packageManager": "pnpm@10.33.0+sha512.10568bb4a6afb58c9eb3630da90cc9516417abebd3fabbe6739f0ae795728da1491e9db5a544c76ad8eb7570f5c4bb3d6c637b2cb41bfdcdb47fa823c8649319",
+  "pnpm": {
+    "ignoredBuiltDependencies": [
+      "esbuild",
+      "lefthook"
+    ],
+    "overrides": {
+      "vite": "8.0.10"
+    }
+  }
 }

package/dist/chunk-BQLLI7GS.js

@@ -1,60 +0,0 @@
-// src/scanner/validation.ts
-var MIN_BSP_NUMBER = 10;
-var MAX_BSP_NUMBER = 99;
-function isValidBSPNumber(n) {
-  return n >= MIN_BSP_NUMBER && n <= MAX_BSP_NUMBER;
-}
-function validateBSPNumber(n) {
-  if (!isValidBSPNumber(n)) {
-    throw new Error(
-      `BSP number must be between ${MIN_BSP_NUMBER} and ${MAX_BSP_NUMBER}, got ${n}`
-    );
-  }
-  return n;
-}
-
-// src/scanner/patterns.ts
-var WORK_ITEM_PATTERN = /^(capability|feature|story)-(\d+)_([a-z][a-z0-9-]*)$/;
-function parseWorkItemName(dirName) {
-  const match = WORK_ITEM_PATTERN.exec(dirName);
-  if (!match) {
-    throw new Error(
-      `Invalid work item name: "${dirName}". Expected format: {kind}-{number}_{slug} (e.g., "capability-21_core-cli", "feature-21_pattern-matching")`
-    );
-  }
-  const kind = match[1];
-  const bspNumber = parseInt(match[2], 10);
-  const slug = match[3];
-  validateBSPNumber(bspNumber);
-  const number = kind === "capability" ? bspNumber - 1 : bspNumber;
-  return {
-    kind,
-    number,
-    slug
-  };
-}
-
-// src/types.ts
-var WORK_ITEM_KINDS = [
-  "capability",
-  "feature",
-  "story"
-];
-var LEAF_KIND = WORK_ITEM_KINDS.at(-1);
-var WORK_ITEM_STATUSES = [
-  "OPEN",
-  "IN_PROGRESS",
-  "DONE"
-];
-
-export {
-  MIN_BSP_NUMBER,
-  MAX_BSP_NUMBER,
-  isValidBSPNumber,
-  validateBSPNumber,
-  parseWorkItemName,
-  WORK_ITEM_KINDS,
-  LEAF_KIND,
-  WORK_ITEM_STATUSES
-};
-//# sourceMappingURL=chunk-BQLLI7GS.js.map

package/dist/chunk-BQLLI7GS.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/scanner/validation.ts","../src/scanner/patterns.ts","../src/types.ts"],"sourcesContent":["/**\n * Validation functions for BSP (Behavior, Structure, Property) numbers\n */\n\n/**\n * BSP number range constants\n */\nexport const MIN_BSP_NUMBER = 10;\nexport const MAX_BSP_NUMBER = 99;\n\n/**\n * Check if a number is a valid BSP number\n *\n * @param n - Number to validate\n * @returns true if n is in range [10, 99], false otherwise\n *\n * @example\n * ```typescript\n * isValidBSPNumber(20)  // true\n * isValidBSPNumber(9)   // false\n * isValidBSPNumber(100) // false\n * ```\n */\nexport function isValidBSPNumber(n: number): boolean {\n  return n >= MIN_BSP_NUMBER && n <= MAX_BSP_NUMBER;\n}\n\n/**\n * Validate a BSP number and throw if invalid\n *\n * @param n - Number to validate\n * @returns The validated number\n * @throws Error if the number is outside the valid range [10, 99]\n *\n * @example\n * ```typescript\n * validateBSPNumber(20)  // returns 20\n * validateBSPNumber(5)   // throws Error: \"BSP number must be between 10 and 99, got 5\"\n * ```\n */\nexport function validateBSPNumber(n: number): number {\n  if (!isValidBSPNumber(n)) {\n    throw new Error(\n      `BSP number must be between ${MIN_BSP_NUMBER} and ${MAX_BSP_NUMBER}, got ${n}`,\n    );\n  }\n  return n;\n}\n","/**\n * Pattern matching for work item directory names\n */\nimport type { WorkItem, WorkItemKind } from \"../types.js\";\nimport { validateBSPNumber } from \"./validation.js\";\n\n/**\n * Regex pattern for work item directory names\n * Format: {kind}-{number}_{slug}\n * - kind: capability, feature, or story\n * - number: BSP number (10-99)\n * - slug: kebab-case identifier (lowercase, hyphens only)\n */\nconst WORK_ITEM_PATTERN = /^(capability|feature|story)-(\\d+)_([a-z][a-z0-9-]*)$/;\n\n/**\n * Parse a work item directory name into structured data\n *\n * @param dirName - Directory name to parse\n * @returns Parsed work item with kind, number, and slug (path not included)\n * @throws Error if the directory name doesn't match the pattern or BSP number is invalid\n *\n * @example\n * ```typescript\n * parseWorkItemName(\"capability-21_core-cli\")\n * // Returns: { kind: \"capability\", number: 20, slug: \"core-cli\" }\n *\n * parseWorkItemName(\"feature-21_pattern-matching\")\n * // Returns: { kind: \"feature\", number: 21, slug: \"pattern-matching\" }\n * ```\n */\nexport function parseWorkItemName(dirName: string): Omit<WorkItem, \"path\"> {\n  const match = WORK_ITEM_PATTERN.exec(dirName);\n\n  if (!match) {\n    throw new Error(\n      `Invalid work item name: \"${dirName}\". Expected format: {kind}-{number}_{slug} `\n        + `(e.g., \"capability-21_core-cli\", \"feature-21_pattern-matching\")`,\n    );\n  }\n\n  const kind = match[1] as WorkItemKind;\n  const bspNumber = parseInt(match[2], 10);\n  const slug = match[3];\n\n  // Validate BSP number range using validation module\n  validateBSPNumber(bspNumber);\n\n  // Capabilities use 0-indexed numbers (directory number - 1)\n  // Features and stories use directory number as-is\n  const number = kind === \"capability\" ? bspNumber - 1 : bspNumber;\n\n  return {\n    kind,\n    number,\n    slug,\n  };\n}\n","/**\n * Core type definitions for spx\n */\n\n/**\n * Work item types in the spec hierarchy\n */\nexport type WorkItemKind = \"capability\" | \"feature\" | \"story\";\n\n/**\n * Ordered hierarchy of work item kinds (root to leaf)\n *\n * Used by both production code and tests to derive hierarchy structure.\n * Per ADR-21: Never hardcode kind names - derive from this constant.\n */\nexport const WORK_ITEM_KINDS: readonly WorkItemKind[] = [\n  \"capability\",\n  \"feature\",\n  \"story\",\n] as const;\n\n/**\n * The leaf kind (actionable work items)\n *\n * Derived from WORK_ITEM_KINDS to ensure consistency if hierarchy changes.\n */\nexport const LEAF_KIND: WorkItemKind = WORK_ITEM_KINDS.at(-1)!;\n\n/**\n * Parsed work item structure\n */\nexport interface WorkItem {\n  /** The type of work item */\n  kind: WorkItemKind;\n  /** BSP number (0-indexed for capabilities, as-is for features/stories) */\n  number: number;\n  /** URL-safe slug identifier */\n  slug: string;\n  /** Full filesystem path to work item directory */\n  path: string;\n}\n\n/**\n * Directory entry from filesystem traversal\n */\nexport interface DirectoryEntry {\n  /** Directory name (basename) */\n  name: string;\n  /** Full absolute path */\n  path: string;\n  /** Whether this is a directory */\n  isDirectory: boolean;\n}\n\n/**\n * Work item status\n */\nexport type WorkItemStatus = \"OPEN\" | \"IN_PROGRESS\" | \"DONE\";\n\n/**\n * Ordered list of work item statuses\n *\n * Used by both production code and tests to derive status values.\n * Per ADR-21: Never hardcode status names - derive from this constant.\n */\nexport const WORK_ITEM_STATUSES: readonly WorkItemStatus[] = [\n  \"OPEN\",\n  \"IN_PROGRESS\",\n  \"DONE\",\n] as const;\n"],"mappings":";AAOO,IAAM,iBAAiB;AACvB,IAAM,iBAAiB;AAevB,SAAS,iBAAiB,GAAoB;AACnD,SAAO,KAAK,kBAAkB,KAAK;AACrC;AAeO,SAAS,kBAAkB,GAAmB;AACnD,MAAI,CAAC,iBAAiB,CAAC,GAAG;AACxB,UAAM,IAAI;AAAA,MACR,8BAA8B,cAAc,QAAQ,cAAc,SAAS,CAAC;AAAA,IAC9E;AAAA,EACF;AACA,SAAO;AACT;;;AClCA,IAAM,oBAAoB;AAkBnB,SAAS,kBAAkB,SAAyC;AACzE,QAAM,QAAQ,kBAAkB,KAAK,OAAO;AAE5C,MAAI,CAAC,OAAO;AACV,UAAM,IAAI;AAAA,MACR,4BAA4B,OAAO;AAAA,IAErC;AAAA,EACF;AAEA,QAAM,OAAO,MAAM,CAAC;AACpB,QAAM,YAAY,SAAS,MAAM,CAAC,GAAG,EAAE;AACvC,QAAM,OAAO,MAAM,CAAC;AAGpB,oBAAkB,SAAS;AAI3B,QAAM,SAAS,SAAS,eAAe,YAAY,IAAI;AAEvD,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;;;AC1CO,IAAM,kBAA2C;AAAA,EACtD;AAAA,EACA;AAAA,EACA;AACF;AAOO,IAAM,YAA0B,gBAAgB,GAAG,EAAE;AAuCrD,IAAM,qBAAgD;AAAA,EAC3D;AAAA,EACA;AAAA,EACA;AACF;","names":[]}

package/dist/index.d.ts

@@ -1,116 +0,0 @@
-/**
- * Core type definitions for spx
- */
-/**
- * Work item types in the spec hierarchy
- */
-type WorkItemKind = "capability" | "feature" | "story";
-/**
- * Ordered hierarchy of work item kinds (root to leaf)
- *
- * Used by both production code and tests to derive hierarchy structure.
- * Per ADR-21: Never hardcode kind names - derive from this constant.
- */
-declare const WORK_ITEM_KINDS: readonly WorkItemKind[];
-/**
- * The leaf kind (actionable work items)
- *
- * Derived from WORK_ITEM_KINDS to ensure consistency if hierarchy changes.
- */
-declare const LEAF_KIND: WorkItemKind;
-/**
- * Parsed work item structure
- */
-interface WorkItem {
-    /** The type of work item */
-    kind: WorkItemKind;
-    /** BSP number (0-indexed for capabilities, as-is for features/stories) */
-    number: number;
-    /** URL-safe slug identifier */
-    slug: string;
-    /** Full filesystem path to work item directory */
-    path: string;
-}
-/**
- * Directory entry from filesystem traversal
- */
-interface DirectoryEntry {
-    /** Directory name (basename) */
-    name: string;
-    /** Full absolute path */
-    path: string;
-    /** Whether this is a directory */
-    isDirectory: boolean;
-}
-/**
- * Work item status
- */
-type WorkItemStatus = "OPEN" | "IN_PROGRESS" | "DONE";
-/**
- * Ordered list of work item statuses
- *
- * Used by both production code and tests to derive status values.
- * Per ADR-21: Never hardcode status names - derive from this constant.
- */
-declare const WORK_ITEM_STATUSES: readonly WorkItemStatus[];
-
-/**
- * Pattern matching for work item directory names
- */
-
-/**
- * Parse a work item directory name into structured data
- *
- * @param dirName - Directory name to parse
- * @returns Parsed work item with kind, number, and slug (path not included)
- * @throws Error if the directory name doesn't match the pattern or BSP number is invalid
- *
- * @example
- * ```typescript
- * parseWorkItemName("capability-21_core-cli")
- * // Returns: { kind: "capability", number: 20, slug: "core-cli" }
- *
- * parseWorkItemName("feature-21_pattern-matching")
- * // Returns: { kind: "feature", number: 21, slug: "pattern-matching" }
- * ```
- */
-declare function parseWorkItemName(dirName: string): Omit<WorkItem, "path">;
-
-/**
- * Validation functions for BSP (Behavior, Structure, Property) numbers
- */
-/**
- * BSP number range constants
- */
-declare const MIN_BSP_NUMBER = 10;
-declare const MAX_BSP_NUMBER = 99;
-/**
- * Check if a number is a valid BSP number
- *
- * @param n - Number to validate
- * @returns true if n is in range [10, 99], false otherwise
- *
- * @example
- * ```typescript
- * isValidBSPNumber(20)  // true
- * isValidBSPNumber(9)   // false
- * isValidBSPNumber(100) // false
- * ```
- */
-declare function isValidBSPNumber(n: number): boolean;
-/**
- * Validate a BSP number and throw if invalid
- *
- * @param n - Number to validate
- * @returns The validated number
- * @throws Error if the number is outside the valid range [10, 99]
- *
- * @example
- * ```typescript
- * validateBSPNumber(20)  // returns 20
- * validateBSPNumber(5)   // throws Error: "BSP number must be between 10 and 99, got 5"
- * ```
- */
-declare function validateBSPNumber(n: number): number;
-
-export { type DirectoryEntry, LEAF_KIND, MAX_BSP_NUMBER, MIN_BSP_NUMBER, WORK_ITEM_KINDS, WORK_ITEM_STATUSES, type WorkItem, type WorkItemKind, type WorkItemStatus, isValidBSPNumber, parseWorkItemName, validateBSPNumber };

package/dist/index.js

@@ -1,21 +0,0 @@
-import {
-  LEAF_KIND,
-  MAX_BSP_NUMBER,
-  MIN_BSP_NUMBER,
-  WORK_ITEM_KINDS,
-  WORK_ITEM_STATUSES,
-  isValidBSPNumber,
-  parseWorkItemName,
-  validateBSPNumber
-} from "./chunk-BQLLI7GS.js";
-export {
-  LEAF_KIND,
-  MAX_BSP_NUMBER,
-  MIN_BSP_NUMBER,
-  WORK_ITEM_KINDS,
-  WORK_ITEM_STATUSES,
-  isValidBSPNumber,
-  parseWorkItemName,
-  validateBSPNumber
-};
-//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}