@spekn/cli 1.0.0 → 1.0.1

package/dist/spec-drift-check.js

@@ -1,186 +0,0 @@
-#!/usr/bin/env node
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.main = main;
-const shared_1 = require("@spekn/shared");
-const cli_runtime_1 = require("./utils/cli-runtime");
-async function columnExists(tableName, columnName) {
-    const rows = (await shared_1.AppDataSource.query(`
-      SELECT 1
-      FROM information_schema.columns
-      WHERE table_schema = current_schema()
-        AND table_name = $1
-        AND column_name = $2
-      LIMIT 1
-    `, [tableName, columnName]));
-    return rows.length > 0;
-}
-function parseArgs(args) {
-    const options = {};
-    for (const arg of args) {
-        if (arg.startsWith("--project-id=")) {
-            options.projectId = arg.split("=")[1];
-        }
-        else if (arg.startsWith("--spec-id=")) {
-            options.specId = arg.split("=")[1];
-        }
-        else if (arg === "--json" || arg === "-j") {
-            options.json = true;
-        }
-        else if (arg === "--verbose" || arg === "-v") {
-            options.verbose = true;
-        }
-    }
-    return options;
-}
-function printHelp() {
-    console.log(`
-spec-drift-check - Fail when task/spec bindings drift
-
-USAGE:
-  npm run spec-drift-check [OPTIONS]
-
-OPTIONS:
-  --project-id=<id>   Filter by project ID
-  --spec-id=<id>      Filter by specification ID
-  -j, --json          Output JSON
-  -v, --verbose       Print individual drift rows
-  -h, --help          Show this help message
-`);
-}
-async function main(argv) {
-    const args = argv ?? process.argv.slice(2);
-    if ((0, cli_runtime_1.hasHelpFlag)(args)) {
-        printHelp();
-        return 0;
-    }
-    const options = parseArgs(args);
-    const hasDbConfig = Boolean(process.env.DATABASE_URL ||
-        process.env.DB_HOST ||
-        process.env.DB_NAME ||
-        process.env.POSTGRES_HOST);
-    if (!hasDbConfig) {
-        console.log("spec-drift-check: skipped (no database configuration found in environment).");
-        return 0;
-    }
-    await shared_1.AppDataSource.initialize();
-    try {
-        const hasTaskSpecVersion = await columnExists("task", "specVersion");
-        const hasTaskSpecRef = await columnExists("task", "specRef");
-        const hasSpecVersion = await columnExists("specification", "version");
-        const hasSpecRef = await columnExists("specification", "specRef");
-        const filters = [];
-        const params = [];
-        if (options.projectId) {
-            params.push(options.projectId);
-            filters.push(`t."projectId" = $${params.length}`);
-        }
-        if (options.specId) {
-            params.push(options.specId);
-            filters.push(`t."specificationId" = $${params.length}`);
-        }
-        const whereClause = filters.length > 0 ? `WHERE ${filters.join(" AND ")}` : "";
-        const taskSpecVersionExpr = hasTaskSpecVersion
-            ? `t."specVersion"`
-            : `NULL::text`;
-        const taskSpecRefExpr = hasTaskSpecRef ? `t."specRef"` : `NULL::text`;
-        const currentSpecVersionExpr = hasSpecVersion
-            ? `s."version"`
-            : `NULL::text`;
-        const currentSpecRefExpr = hasSpecRef ? `s."specRef"` : `NULL::text`;
-        const rows = (await shared_1.AppDataSource.query(`
-        SELECT
-          t."id" AS "taskId",
-          t."title" AS "taskTitle",
-          t."specificationId" AS "specificationId",
-          s."id" AS "specId",
-          s."title" AS "specTitle",
-          ${taskSpecVersionExpr} AS "taskSpecVersion",
-          ${taskSpecRefExpr} AS "taskSpecRef",
-          ${currentSpecVersionExpr} AS "currentSpecVersion",
-          ${currentSpecRefExpr} AS "currentSpecRef"
-        FROM "task" t
-        LEFT JOIN "specification" s ON s."id" = t."specificationId"
-        ${whereClause}
-      `, params));
-        const driftItems = rows
-            .map((row) => {
-            const driftReasons = [];
-            if (!row.specId) {
-                driftReasons.push("spec_missing");
-            }
-            if (!hasTaskSpecVersion || !row.taskSpecVersion) {
-                driftReasons.push("task_spec_version_missing");
-            }
-            if (!hasTaskSpecRef || !row.taskSpecRef) {
-                driftReasons.push("task_spec_ref_missing");
-            }
-            if (!hasSpecRef) {
-                driftReasons.push("spec_ref_missing");
-            }
-            if (row.taskSpecVersion &&
-                row.currentSpecVersion &&
-                row.taskSpecVersion !== row.currentSpecVersion) {
-                driftReasons.push("spec_version_drift");
-            }
-            if (row.taskSpecRef &&
-                row.currentSpecRef &&
-                row.taskSpecRef !== row.currentSpecRef) {
-                driftReasons.push("spec_ref_drift");
-            }
-            return {
-                taskId: row.taskId,
-                taskTitle: row.taskTitle,
-                specificationId: row.specificationId,
-                specTitle: row.specTitle || "<missing specification>",
-                taskSpecVersion: row.taskSpecVersion,
-                currentSpecVersion: row.currentSpecVersion,
-                taskSpecRef: row.taskSpecRef,
-                currentSpecRef: row.currentSpecRef,
-                driftReasons,
-            };
-        })
-            .filter((item) => item.driftReasons.length > 0);
-        const summary = {
-            checkedTasks: rows.length,
-            driftedTasks: driftItems.length,
-            versionDrift: driftItems.filter((d) => d.driftReasons.includes("spec_version_drift")).length,
-            refDrift: driftItems.filter((d) => d.driftReasons.includes("spec_ref_drift")).length,
-            missingBindings: driftItems.filter((d) => d.driftReasons.includes("task_spec_ref_missing") ||
-                d.driftReasons.includes("task_spec_version_missing")).length,
-            missingSpecs: driftItems.filter((d) => d.driftReasons.includes("spec_missing")).length,
-        };
-        if (options.json) {
-            console.log(JSON.stringify({ summary, items: driftItems }, null, 2));
-        }
-        else {
-            console.log("Spec Drift Check");
-            console.log(`Checked tasks: ${summary.checkedTasks}`);
-            console.log(`Drifted tasks: ${summary.driftedTasks}`);
-            console.log(`Version drift: ${summary.versionDrift}`);
-            console.log(`Ref drift: ${summary.refDrift}`);
-            console.log(`Missing bindings: ${summary.missingBindings}`);
-            console.log(`Missing specs: ${summary.missingSpecs}`);
-            if (options.verbose && driftItems.length > 0) {
-                console.log("\nDrift items:");
-                for (const item of driftItems) {
-                    console.log(`- ${item.taskTitle} (${item.taskId})`);
-                    console.log(`  Spec: ${item.specTitle} (${item.specificationId})`);
-                    console.log(`  Version: ${item.taskSpecVersion ?? "<missing>"} -> ${item.currentSpecVersion ?? "<missing>"}`);
-                    console.log(`  Ref: ${item.taskSpecRef ?? "<missing>"} -> ${item.currentSpecRef ?? "<missing>"}`);
-                    console.log(`  Reasons: ${item.driftReasons.join(", ")}`);
-                }
-            }
-        }
-        if (driftItems.length > 0) {
-            return 2;
-        }
-        return 0;
-    }
-    finally {
-        await shared_1.AppDataSource.destroy();
-    }
-}
-if (require.main === module) {
-    void (0, cli_runtime_1.runCliMain)(main, { errorPrefix: "spec-drift-check failed" });
-}

package/dist/spec-frontmatter.d.ts

@@ -1,11 +0,0 @@
-#!/usr/bin/env node
-/**
- * spec-frontmatter CLI Tool
- *
- * Parse and validate YAML frontmatter from a specification file.
- *
- * Usage: spekn spec frontmatter <spec-file-path> [OPTIONS]
- * Example: spekn spec frontmatter specs/SPECIFICATION.md
- */
-declare function main(argv?: string[]): number;
-export { main };

package/dist/spec-frontmatter.js

@@ -1,219 +0,0 @@
-#!/usr/bin/env node
-"use strict";
-/**
- * spec-frontmatter CLI Tool
- *
- * Parse and validate YAML frontmatter from a specification file.
- *
- * Usage: spekn spec frontmatter <spec-file-path> [OPTIONS]
- * Example: spekn spec frontmatter specs/SPECIFICATION.md
- */
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.main = main;
-const fs = __importStar(require("fs"));
-const path = __importStar(require("path"));
-const shared_1 = require("@spekn/shared");
-const cli_runtime_1 = require("./utils/cli-runtime");
-function parseArgs(args) {
-    const options = {};
-    let filePath;
-    for (let i = 0; i < args.length; i++) {
-        const arg = args[i];
-        if (arg === "--verbose" || arg === "-v") {
-            options.verbose = true;
-        }
-        else if (arg === "--json" || arg === "-j") {
-            options.json = true;
-        }
-        else if (arg === "--validate-only") {
-            options.validateOnly = true;
-        }
-        else if (arg === "--auto-generate") {
-            options.autoGenerate = true;
-        }
-        else if (!arg.startsWith("-")) {
-            filePath = arg;
-        }
-    }
-    if (!filePath) {
-        throw new Error("missing required argument: <spec-file-path>");
-    }
-    return { filePath, options };
-}
-function printHelp() {
-    console.log(`
-spec-frontmatter - Parse and validate specification frontmatter
-
-USAGE:
-  spekn spec frontmatter <spec-file-path> [OPTIONS]
-
-ARGUMENTS:
-  <spec-file-path>      Path to the specification markdown file
-
-OPTIONS:
-  -v, --verbose         Show detailed output including all fields
-  -j, --json            Output in JSON format
-  --validate-only       Only validate, don't display parsed result
-  --auto-generate       Generate minimal frontmatter if missing
-  -h, --help            Show this help message
-
-EXAMPLES:
-  spekn spec frontmatter specs/SPECIFICATION.md
-  spekn spec frontmatter specs/SPECIFICATION.md --json
-  spekn spec frontmatter specs/SPECIFICATION.md --validate-only
-  spekn spec frontmatter specs/SPECIFICATION.md --auto-generate
-`);
-}
-function main(argv) {
-    const args = argv ?? process.argv.slice(2);
-    if ((0, cli_runtime_1.hasHelpFlag)(args)) {
-        printHelp();
-        return 0;
-    }
-    let filePath;
-    let options;
-    try {
-        ({ filePath, options } = parseArgs(args));
-    }
-    catch {
-        console.error("Error: Missing required argument <spec-file-path>");
-        printHelp();
-        return 1;
-    }
-    const resolvedPath = path.resolve(process.cwd(), filePath);
-    if (!fs.existsSync(resolvedPath)) {
-        console.error(`Error: File not found: ${resolvedPath}`);
-        return 1;
-    }
-    let content;
-    try {
-        content = fs.readFileSync(resolvedPath, "utf-8");
-    }
-    catch (error) {
-        console.error(`Error reading file: ${(0, cli_runtime_1.errorMessage)(error)}`);
-        return 1;
-    }
-    const result = (0, shared_1.parseSpecificationFrontmatter)(content);
-    // Auto-generate if requested and no frontmatter found
-    if (!result.hasFrontmatter && options.autoGenerate) {
-        const generated = (0, shared_1.autoGenerateFrontmatter)(content);
-        const yamlStr = (0, shared_1.serializeFrontmatter)(generated);
-        if (options.json) {
-            console.log(JSON.stringify({ frontmatter: generated, autoGenerated: true }, null, 2));
-        }
-        else {
-            console.log("\nNo frontmatter found. Auto-generated minimal frontmatter:\n");
-            console.log(yamlStr);
-            console.log();
-        }
-        return 0;
-    }
-    // Handle validation errors
-    if (result.errors?.length) {
-        if (options.json) {
-            console.log(JSON.stringify({ errors: result.errors, valid: false }, null, 2));
-        }
-        else {
-            console.error(`\nFrontmatter validation failed for ${path.basename(filePath)}:\n`);
-            for (const error of result.errors) {
-                console.error(`  - ${error}`);
-            }
-            console.error();
-        }
-        return 1;
-    }
-    // No frontmatter found
-    if (!result.hasFrontmatter) {
-        if (options.json) {
-            console.log(JSON.stringify({ hasFrontmatter: false, valid: false }, null, 2));
-        }
-        else {
-            console.error(`\nError: No frontmatter found in ${path.basename(filePath)}`);
-            console.error("  Specifications require YAML frontmatter delimited by --- markers.");
-            console.error("  Use --auto-generate to create minimal frontmatter.\n");
-        }
-        return 1;
-    }
-    // Validate-only mode
-    if (options.validateOnly) {
-        if (options.json) {
-            console.log(JSON.stringify({ valid: true }, null, 2));
-        }
-        else {
-            console.log(`\nFrontmatter valid in ${path.basename(filePath)}\n`);
-        }
-        return 0;
-    }
-    // Display parsed frontmatter
-    if (options.json) {
-        console.log(JSON.stringify(result, null, 2));
-    }
-    else {
-        const fm = result.frontmatter;
-        console.log(`\nFrontmatter for ${path.basename(filePath)}:\n`);
-        console.log(`  Title:   ${fm.title}`);
-        console.log(`  Type:    ${fm.type}`);
-        console.log(`  Version: ${fm.version}`);
-        if (fm.status)
-            console.log(`  Status:  ${fm.status}`);
-        if (fm.author)
-            console.log(`  Author:  ${fm.author}`);
-        if (fm.specRef)
-            console.log(`  SpecRef: ${fm.specRef}`);
-        if (fm.tags?.length)
-            console.log(`  Tags:    ${fm.tags.join(", ")}`);
-        if (fm.hints && options.verbose) {
-            console.log("\n  Content Hints:");
-            for (const [layer, hints] of Object.entries(fm.hints)) {
-                if (hints?.length) {
-                    console.log(`    ${layer}:`);
-                    for (const hint of hints) {
-                        console.log(`      - ${hint}`);
-                    }
-                }
-            }
-        }
-        if (fm.dependsOn?.length)
-            console.log(`\n  Dependencies: ${fm.dependsOn.join(", ")}`);
-        if (fm.extends)
-            console.log(`  Extends: ${fm.extends}`);
-        console.log();
-    }
-    return 0;
-}
-if (require.main === module) {
-    void (0, cli_runtime_1.runCliMain)(main, { errorPrefix: "spec-frontmatter failed" });
-}

package/dist/spec-lint.d.ts

@@ -1,11 +0,0 @@
-#!/usr/bin/env node
-/**
- * spec-lint CLI Tool
- *
- * Validate specification markdown quality and structure.
- *
- * Usage: npm run spec-lint <spec-file-path>
- * Example: npm run spec-lint specs/DECISIONS.md
- */
-declare function main(argv?: string[]): number;
-export { main };