sysprom 1.0.0 → 1.0.5

package/dist/src/speckit/project.js

@@ -0,0 +1,141 @@
+import { existsSync, readdirSync, statSync } from "node:fs";
+import { join } from "node:path";
+/**
+ * Detect Spec-Kit project structure from a directory.
+ * Looks for .specify/ and specs/ subdirectories.
+ */
+export function detectSpecKitProject(dir) {
+    const specifyDir = checkDir(join(dir, ".specify"));
+    const specsDir = checkDir(join(dir, "specs"));
+    // Resolve constitution.md - check .specify/memory/ first, then root
+    let constitutionPath = null;
+    if (specifyDir) {
+        const memoryConstitution = join(specifyDir, "memory", "constitution.md");
+        if (existsSync(memoryConstitution)) {
+            constitutionPath = memoryConstitution;
+        }
+    }
+    if (!constitutionPath) {
+        const rootConstitution = join(dir, "constitution.md");
+        if (existsSync(rootConstitution)) {
+            constitutionPath = rootConstitution;
+        }
+    }
+    return {
+        root: dir,
+        specifyDir,
+        specsDir,
+        constitutionPath,
+    };
+}
+/**
+ * List all features in the specs/ directory, sorted by number.
+ */
+export function listFeatures(project) {
+    if (!project.specsDir) {
+        return [];
+    }
+    const features = [];
+    const featurePattern = /^\d{3}-/;
+    try {
+        const entries = readdirSync(project.specsDir);
+        for (const entry of entries) {
+            const featurePath = join(project.specsDir, entry);
+            const stat = statSync(featurePath);
+            // Only process directories matching the feature pattern
+            if (!stat.isDirectory() || !featurePattern.test(entry)) {
+                continue;
+            }
+            const feature = parseFeatureDirectory(featurePath, entry);
+            if (feature) {
+                features.push(feature);
+            }
+        }
+    }
+    catch {
+        // If specs directory cannot be read, return empty list
+        return [];
+    }
+    // Sort by number
+    features.sort((a, b) => a.number - b.number);
+    return features;
+}
+/**
+ * Get a specific feature by number or name.
+ * Matches "001", "001-feature-name", or "feature-name".
+ */
+export function getFeature(project, idOrName) {
+    const features = listFeatures(project);
+    // Try exact match on id first
+    let feature = features.find((f) => f.id === idOrName);
+    if (feature)
+        return feature;
+    // Try match on name
+    feature = features.find((f) => f.name === idOrName);
+    if (feature)
+        return feature;
+    // Try match on number (e.g., "1" or "001")
+    const numberStr = idOrName.padStart(3, "0");
+    feature = features.find((f) => f.id.startsWith(numberStr + "-"));
+    if (feature)
+        return feature;
+    return null;
+}
+/**
+ * Resolve the constitution.md file, checking .specify/memory/ first, then root.
+ */
+export function resolveConstitution(project) {
+    return project.constitutionPath;
+}
+/**
+ * Check if a directory exists, return path or null.
+ */
+function checkDir(path) {
+    try {
+        const stat = statSync(path);
+        return stat.isDirectory() ? path : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Parse a feature directory and extract metadata and file paths.
+ */
+function parseFeatureDirectory(dir, dirName) {
+    // Parse the directory name format: "NNN-feature-name"
+    const match = /^(\d{3})-(.+)$/.exec(dirName);
+    if (!match) {
+        return null;
+    }
+    const [, numberStr, name] = match;
+    const number = parseInt(numberStr, 10);
+    return {
+        id: dirName,
+        number,
+        name,
+        dir,
+        files: {
+            spec: checkFile(dir, "spec.md"),
+            plan: checkFile(dir, "plan.md"),
+            tasks: checkFile(dir, "tasks.md"),
+            checklist: checkFile(dir, "checklist.md"),
+            research: checkFile(dir, "research.md"),
+            dataModel: checkFile(dir, "data-model.md"),
+            quickstart: checkFile(dir, "quickstart.md"),
+        },
+    };
+}
+/**
+ * Check if a file exists in a directory, return path or null.
+ */
+function checkFile(dir, filename) {
+    const path = join(dir, filename);
+    try {
+        const stat = statSync(path);
+        return stat.isFile() ? path : null;
+    }
+    catch {
+        return null;
+    }
+}

package/dist/src/text.d.ts

@@ -0,0 +1,23 @@
+/** Normalise a text field (string | string[]) to a single string, joining with newlines.
+ * @param value - The text field to normalise.
+ * @returns A single string.
+ */
+export declare function textToString(value: string | string[]): string;
+/** Normalise a text field to an array of lines.
+ * @param value - The text field to normalise.
+ * @returns An array of lines.
+ */
+export declare function textToLines(value: string | string[]): string[];
+/** Format a text field for Markdown output — each line becomes a paragraph.
+ * @param value - The text field to format.
+ * @returns Markdown-formatted string.
+ */
+export declare function textToMarkdown(value: string | string[]): string;
+/**
+ * Parse a Markdown text block back into the canonical text representation.
+ * Single-line content stays as a string; multiline becomes an array.
+ *
+ * @param block - The Markdown text block to parse.
+ * @returns A string for single-line content, or an array of lines for multiline.
+ */
+export declare function markdownToText(block: string): string | string[];

package/dist/src/text.js

@@ -0,0 +1,32 @@
+/** Normalise a text field (string | string[]) to a single string, joining with newlines.
+ * @param value - The text field to normalise.
+ * @returns A single string.
+ */
+export function textToString(value) {
+    return Array.isArray(value) ? value.join("\n") : value;
+}
+/** Normalise a text field to an array of lines.
+ * @param value - The text field to normalise.
+ * @returns An array of lines.
+ */
+export function textToLines(value) {
+    return Array.isArray(value) ? value : [value];
+}
+/** Format a text field for Markdown output — each line becomes a paragraph.
+ * @param value - The text field to format.
+ * @returns Markdown-formatted string.
+ */
+export function textToMarkdown(value) {
+    return textToLines(value).join("\n");
+}
+/**
+ * Parse a Markdown text block back into the canonical text representation.
+ * Single-line content stays as a string; multiline becomes an array.
+ *
+ * @param block - The Markdown text block to parse.
+ * @returns A string for single-line content, or an array of lines for multiline.
+ */
+export function markdownToText(block) {
+    const lines = block.split("\n");
+    return lines.length === 1 ? lines[0] : lines;
+}

package/package.json

@@ -1,13 +1,91 @@
 {
   "name": "sysprom",
-  "version": "1.0.0",
-  "description": "",
-  "main": "index.js",
+  "version": "1.0.5",
+  "description": "SysProM — System Provenance Model CLI and library",
+  "author": "ExaDev",
+  "homepage": "https://github.com/ExaDev/SysProM#readme",
+  "bugs": "https://github.com/ExaDev/SysProM/issues",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ExaDev/SysProM.git"
+  },
+  "keywords": [
+    "sysprom",
+    "provenance",
+    "decision",
+    "architecture",
+    "traceability",
+    "system-model",
+    "cli"
+  ],
+  "packageManager": "pnpm@10.32.1",
+  "type": "module",
+  "main": "./dist/src/index.js",
+  "types": "./dist/src/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/src/index.d.ts",
+      "import": "./dist/src/index.js"
+    }
+  },
+  "files": [
+    "dist/src/**/*.js",
+    "dist/src/**/*.d.ts",
+    "schema.json"
+  ],
+  "bin": {
+    "sysprom": "./dist/src/cli/index.js",
+    "spm": "./dist/src/cli/index.js"
+  },
   "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1"
+    "build": "turbo run _build",
+    "typecheck": "turbo run _typecheck",
+    "compile": "turbo run _compile",
+    "schema": "turbo run _schema",
+    "test": "turbo run _test",
+    "test:coverage": "turbo run _test:coverage",
+    "docs": "turbo run _docs:cli _docs:api",
+    "docs:html": "turbo run _docs:cli _docs:api:html",
+    "docs:serve": "typedoc --options typedoc.html.json --watch --serve",
+    "lint": "turbo run _lint",
+    "spm": "tsx src/cli/index.ts",
+    "_lint": "eslint --cache .",
+    "_typecheck": "tsc --noEmit",
+    "_compile": "tsc",
+    "_schema": "tsx src/generate-schema.ts",
+    "_test": "tsx --test tests/*.test.ts",
+    "_test:coverage": "c8 --src src --exclude 'src/cli/**' --exclude 'src/generate-schema.ts' tsx --test tests/*.test.ts",
+    "_docs:cli": "tsx scripts/generate-cli-docs.ts",
+    "_docs:api": "typedoc",
+    "_docs:api:html": "typedoc --options typedoc.html.json",
+    "prepare": "husky"
+  },
+  "dependencies": {
+    "commander": "14.0.3",
+    "picocolors": "1.1.1",
+    "zod": "4.3.6"
   },
-  "keywords": [],
-  "author": "",
-  "license": "ISC",
-  "type": "commonjs"
+  "devDependencies": {
+    "@commitlint/cli": "20.5.0",
+    "@commitlint/config-conventional": "20.5.0",
+    "@eslint/js": "10.0.1",
+    "@semantic-release/changelog": "6.0.3",
+    "@semantic-release/git": "10.0.1",
+    "@types/node": "25.5.0",
+    "c8": "11.0.0",
+    "conventional-changelog-conventionalcommits": "9.3.0",
+    "eslint": "10.1.0",
+    "eslint-config-prettier": "10.1.8",
+    "eslint-plugin-prettier": "5.5.5",
+    "husky": "9.1.7",
+    "prettier": "3.8.1",
+    "semantic-release": "25.0.3",
+    "tsx": "4.21.0",
+    "turbo": "2.8.20",
+    "typedoc": "0.28.17",
+    "typedoc-plugin-markdown": "4.11.0",
+    "typedoc-plugin-zod": "1.4.3",
+    "typescript": "5.9.3",
+    "typescript-eslint": "8.57.1"
+  }
 }