@outcomeeng/spx 0.1.0

package/dist/.validation-timings.json

@@ -0,0 +1,50 @@
+{
+  "circular-deps": {
+    "stepId": "circular-deps",
+    "durations": [
+      864.0509579999999,
+      805.8709170000001,
+      761.4281659999999,
+      1044.54275,
+      986.023125,
+      1082.3886659999998,
+      1236.325292,
+      1165.1319580000002,
+      1097.039792,
+      1005.056208
+    ],
+    "lastRun": 1769540047988
+  },
+  "eslint": {
+    "stepId": "eslint",
+    "durations": [
+      1241.5572080000002,
+      2607.42975,
+      2665.9715,
+      3589.5323750000002,
+      5987.524042000001,
+      8989.211334,
+      5383.232124999999,
+      1237.48825,
+      1224.788458,
+      1374.4576249999998
+    ],
+    "lastRun": 1769540049362
+  },
+  "typescript": {
+    "stepId": "typescript",
+    "durations": [
+      2465.7408750000004,
+      2609.7863329999996,
+      2734.6565000000005,
+      3237.7293329999998,
+      2366.499041,
+      1998.6742919999997,
+      1930.4415000000004,
+      2695.859125,
+      2539.831666,
+      2686.839541
+    ],
+    "lastRun": 1769537859146
+  }
+}

package/dist/chunk-5L7CHFBC.js

@@ -0,0 +1,60 @@
+// 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-5L7CHFBC.js.map

package/dist/chunk-5L7CHFBC.js.map

@@ -0,0 +1 @@
+{"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/cli.d.ts

@@ -0,0 +1,2 @@
+
+export {  }