@spekn/cli 1.0.0 → 1.0.2

package/dist/auth-logout.js

@@ -1,115 +0,0 @@
-#!/usr/bin/env node
-"use strict";
-/**
- * auth logout CLI command
- *
- * Revokes the stored refresh token against Keycloak (best-effort) and then
- * removes the local credentials file at ~/.spekn/credentials.json.
- *
- * Usage: spekn auth logout
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.runAuthLogoutCli = runAuthLogoutCli;
-exports.main = main;
-exports.parseArgs = parseArgs;
-const credentials_store_js_1 = require("./auth/credentials-store.js");
-const help_error_1 = require("./utils/help-error");
-const structured_log_1 = require("./utils/structured-log");
-/** Default revocation implementation — best-effort, ignores errors. */
-async function defaultRevokeToken(logoutUrl, body) {
-    await fetch(logoutUrl, {
-        method: "POST",
-        headers: { "Content-Type": "application/x-www-form-urlencoded" },
-        body: body.toString(),
-    });
-}
-const defaultDeps = {
-    stdout: process.stdout,
-    stderr: process.stderr,
-    credentialsStore: new credentials_store_js_1.CredentialsStore(),
-    revokeToken: defaultRevokeToken,
-};
-function resolveDeps(deps) {
-    return {
-        stdout: deps?.stdout ?? defaultDeps.stdout,
-        stderr: deps?.stderr ?? defaultDeps.stderr,
-        credentialsStore: deps?.credentialsStore ?? defaultDeps.credentialsStore,
-        revokeToken: deps?.revokeToken ?? defaultDeps.revokeToken,
-    };
-}
-function printHelp(stderr) {
-    stderr.write(`
-auth logout - Revoke the current session and remove stored credentials
-
-USAGE:
-  spekn auth logout
-
-OPTIONS:
-  --help   Show this help message
-
-EXAMPLES:
-  spekn auth logout
-`);
-}
-function parseArgs(args) {
-    for (const arg of args) {
-        if (arg === "--help" || arg === "-h") {
-            throw new help_error_1.HelpRequestedError();
-        }
-    }
-}
-async function runAuthLogoutCli(args, deps) {
-    const resolved = resolveDeps(deps);
-    try {
-        parseArgs(args);
-        (0, structured_log_1.appendCliStructuredLog)({
-            source: "cli.auth.logout",
-            level: "info",
-            message: "Starting auth logout",
-        });
-        const credentials = resolved.credentialsStore.load();
-        if (credentials !== null && credentials.refreshToken) {
-            const logoutUrl = `${credentials.keycloakUrl}/realms/${credentials.realm}/protocol/openid-connect/logout`;
-            const body = new URLSearchParams({
-                client_id: "spekn-cli",
-                refresh_token: credentials.refreshToken,
-            });
-            try {
-                await resolved.revokeToken(logoutUrl, body);
-            }
-            catch {
-                // Best-effort: ignore revocation errors so local credentials are always
-                // cleared even when Keycloak is unreachable.
-            }
-        }
-        resolved.credentialsStore.clear();
-        resolved.stdout.write("Logged out successfully.\n");
-        (0, structured_log_1.appendCliStructuredLog)({
-            source: "cli.auth.logout",
-            level: "info",
-            message: "Auth logout completed",
-        });
-        return 0;
-    }
-    catch (error) {
-        if (error instanceof help_error_1.HelpRequestedError) {
-            printHelp(resolved.stderr);
-            return 0;
-        }
-        const message = error instanceof Error ? error.message : String(error);
-        resolved.stderr.write(`Error: ${message}\n`);
-        (0, structured_log_1.appendCliStructuredLog)({
-            source: "cli.auth.logout",
-            level: "error",
-            message,
-        });
-        return 1;
-    }
-}
-async function main() {
-    const exitCode = await runAuthLogoutCli(process.argv.slice(2));
-    process.exit(exitCode);
-}
-if (require.main === module) {
-    void main();
-}

package/dist/auth-status.d.ts

@@ -1,24 +0,0 @@
-#!/usr/bin/env node
-/**
- * auth status CLI command
- *
- * Displays the current authentication state: logged-in user, token expiry,
- * and organization (if set). Attempts a silent token refresh when the stored
- * token is expired but a refresh token is available.
- *
- * Usage: spekn auth status
- */
-import { CredentialsStore } from "./auth/credentials-store.js";
-interface Deps {
-    stdout: {
-        write(s: string): void;
-    };
-    stderr: {
-        write(s: string): void;
-    };
-    credentialsStore: CredentialsStore;
-}
-declare function parseArgs(args: string[]): void;
-export declare function runAuthStatusCli(args: string[], deps?: Partial<Deps>): Promise<number>;
-declare function main(): Promise<void>;
-export { main, parseArgs };

package/dist/auth-status.js

@@ -1,109 +0,0 @@
-#!/usr/bin/env node
-"use strict";
-/**
- * auth status CLI command
- *
- * Displays the current authentication state: logged-in user, token expiry,
- * and organization (if set). Attempts a silent token refresh when the stored
- * token is expired but a refresh token is available.
- *
- * Usage: spekn auth status
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.runAuthStatusCli = runAuthStatusCli;
-exports.main = main;
-exports.parseArgs = parseArgs;
-const credentials_store_js_1 = require("./auth/credentials-store.js");
-const help_error_1 = require("./utils/help-error");
-const structured_log_1 = require("./utils/structured-log");
-const defaultDeps = {
-    stdout: process.stdout,
-    stderr: process.stderr,
-    credentialsStore: new credentials_store_js_1.CredentialsStore(),
-};
-function resolveDeps(deps) {
-    return {
-        stdout: deps?.stdout ?? defaultDeps.stdout,
-        stderr: deps?.stderr ?? defaultDeps.stderr,
-        credentialsStore: deps?.credentialsStore ?? defaultDeps.credentialsStore,
-    };
-}
-function printHelp(stderr) {
-    stderr.write(`
-auth status - Show the current authentication status
-
-USAGE:
-  spekn auth status
-
-OPTIONS:
-  --help   Show this help message
-
-EXAMPLES:
-  spekn auth status
-`);
-}
-function parseArgs(args) {
-    for (const arg of args) {
-        if (arg === "--help" || arg === "-h") {
-            throw new help_error_1.HelpRequestedError();
-        }
-    }
-}
-async function runAuthStatusCli(args, deps) {
-    const resolved = resolveDeps(deps);
-    try {
-        parseArgs(args);
-        (0, structured_log_1.appendCliStructuredLog)({
-            source: "cli.auth.status",
-            level: "info",
-            message: "Checking auth status",
-        });
-        const credentials = resolved.credentialsStore.load();
-        if (credentials === null) {
-            resolved.stdout.write("Not logged in. Run `spekn auth login` to authenticate.\n");
-            return 1;
-        }
-        const token = await resolved.credentialsStore.getValidToken();
-        if (token === null) {
-            resolved.stdout.write("Session expired. Run `spekn auth login` to re-authenticate.\n");
-            return 1;
-        }
-        // Reload credentials after a potential refresh so we report the updated
-        // expiry time rather than the stale one.
-        const fresh = resolved.credentialsStore.load() ?? credentials;
-        const email = fresh.user?.email ?? "unknown";
-        const expiresAt = new Date(fresh.expiresAt).toLocaleString();
-        const orgId = fresh.organizationId ?? "not set";
-        resolved.stdout.write(`Logged in as ${email}\n`);
-        resolved.stdout.write(`Token expires: ${expiresAt}\n`);
-        resolved.stdout.write(`Organization: ${orgId}\n`);
-        (0, structured_log_1.appendCliStructuredLog)({
-            source: "cli.auth.status",
-            level: "info",
-            message: "Auth status available",
-            details: { email, organizationId: orgId },
-        });
-        return 0;
-    }
-    catch (error) {
-        if (error instanceof help_error_1.HelpRequestedError) {
-            printHelp(resolved.stderr);
-            return 0;
-        }
-        const message = error instanceof Error ? error.message : String(error);
-        resolved.stderr.write(`Error: ${message}\n`);
-        (0, structured_log_1.appendCliStructuredLog)({
-            source: "cli.auth.status",
-            level: "error",
-            message,
-        });
-        return 1;
-    }
-}
-async function main() {
-    const exitCode = await runAuthStatusCli(process.argv.slice(2));
-    process.exit(exitCode);
-}
-if (require.main === module) {
-    void main();
-}

package/dist/backlog-generate.d.ts

@@ -1,11 +0,0 @@
-#!/usr/bin/env node
-/**
- * backlog-generate CLI Tool
- *
- * Auto-generate tasks from specification anchors.
- *
- * Usage: npm run backlog-generate <spec-file-path> [OPTIONS]
- * Example: npm run backlog-generate specs/WORKFLOW.md --project-id=<uuid>
- */
-declare function main(argv?: string[]): Promise<number>;
-export { main };

package/dist/backlog-generate.js

@@ -1,308 +0,0 @@
-#!/usr/bin/env node
-"use strict";
-/**
- * backlog-generate CLI Tool
- *
- * Auto-generate tasks from specification anchors.
- *
- * Usage: npm run backlog-generate <spec-file-path> [OPTIONS]
- * Example: npm run backlog-generate specs/WORKFLOW.md --project-id=<uuid>
- */
-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 agents_1 = require("@spekn/agents");
-const shared_1 = require("@spekn/shared");
-const shared_2 = require("@spekn/shared");
-const shared_3 = require("@spekn/shared");
-const cli_runtime_1 = require("./utils/cli-runtime");
-function parseArgs(args) {
-    const options = { dryRun: false, verbose: false };
-    let filePath;
-    for (let i = 0; i < args.length; i++) {
-        const arg = args[i];
-        if (arg.startsWith("--project-id=")) {
-            options.projectId = arg.split("=")[1];
-        }
-        else if (arg.startsWith("--spec-id=")) {
-            options.specId = arg.split("=")[1];
-        }
-        else if (arg.startsWith("--priority=")) {
-            const priority = arg.split("=")[1];
-            if (Object.values(shared_2.TaskPriority).includes(priority)) {
-                options.priority = priority;
-            }
-        }
-        else if (arg === "--dry-run" || arg === "-d") {
-            options.dryRun = true;
-        }
-        else if (arg === "--verbose" || arg === "-v") {
-            options.verbose = 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(`
-backlog-generate - Auto-generate tasks from specification anchors
-
-USAGE:
-  npm run backlog-generate <spec-file-path> [OPTIONS]
-
-ARGUMENTS:
-  <spec-file-path>    Path to the specification markdown file
-
-OPTIONS:
-  --project-id=<id>   Project ID to associate tasks with (required for DB insert)
-  --spec-id=<id>      Specification ID to associate tasks with (required for DB insert)
-  --priority=<level>  Default task priority (low|medium|high|critical, default: medium)
-  -d, --dry-run       Preview tasks without creating them
-  -v, --verbose       Show detailed output
-  -h, --help          Show this help message
-
-EXAMPLES:
-  npm run backlog-generate specs/WORKFLOW.md --dry-run
-  npm run backlog-generate specs/WORKFLOW.md --project-id=abc123 --spec-id=def456
-  npm run backlog-generate specs/SPECIFICATION.md --priority=high --verbose
-`);
-}
-function extractAcceptanceCriteria(content) {
-    const criteria = [];
-    // Look for "Acceptance Criteria" section
-    const lines = content.split("\n");
-    let inCriteriaSection = false;
-    for (const line of lines) {
-        if (line.match(/^\*\*Acceptance Criteria\*\*:|^##\s*Acceptance Criteria|^###\s*Acceptance Criteria/i)) {
-            inCriteriaSection = true;
-            continue;
-        }
-        // Stop at next section heading or bold marker
-        if (inCriteriaSection &&
-            (line.match(/^##[^#]|^\*\*[^*]+\*\*:/) || line.trim() === "---")) {
-            break;
-        }
-        // Extract list items
-        if (inCriteriaSection && line.match(/^[-*]\s+/)) {
-            const criterion = line.replace(/^[-*]\s+/, "").trim();
-            if (criterion) {
-                criteria.push(criterion);
-            }
-        }
-    }
-    // If no explicit criteria found, look for bullet points
-    if (criteria.length === 0) {
-        for (const line of lines) {
-            if (line.match(/^[-*]\s+/)) {
-                const item = line.replace(/^[-*]\s+/, "").trim();
-                if (item && !item.startsWith("**")) {
-                    criteria.push(item);
-                }
-            }
-        }
-    }
-    return criteria;
-}
-function extractDependencies(content) {
-    const dependencies = [];
-    // Look for "Dependencies" section
-    const dependencyMatch = content.match(/\*\*Dependencies\*\*:([^\n]+)/i);
-    if (dependencyMatch) {
-        const dependencyText = dependencyMatch[1];
-        const dependencyAnchors = dependencyText.match(/#[a-z0-9._-]+/gi);
-        if (dependencyAnchors) {
-            dependencies.push(...dependencyAnchors.map((d) => d.replace(/^#/, "")));
-        }
-    }
-    return dependencies;
-}
-async 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;
-    }
-    // Resolve file path
-    const resolvedPath = path.resolve(process.cwd(), filePath);
-    // Check if file exists
-    if (!fs.existsSync(resolvedPath)) {
-        console.error(`Error: File not found: ${resolvedPath}`);
-        return 1;
-    }
-    // Read file content
-    let content;
-    try {
-        content = fs.readFileSync(resolvedPath, "utf-8");
-    }
-    catch (error) {
-        console.error(`Error reading file: ${(0, cli_runtime_1.errorMessage)(error)}`);
-        return 1;
-    }
-    // Extract anchors
-    const anchors = (0, agents_1.extractAnchors)(content);
-    if (anchors.length === 0) {
-        console.log("No anchors found in the specification.");
-        return 0;
-    }
-    console.log(`\nFound ${anchors.length} anchor(s) in ${path.basename(filePath)}`);
-    // Generate tasks from anchors
-    const tasksToCreate = [];
-    for (const anchor of anchors) {
-        const anchorContent = (0, agents_1.extractAnchorContent)(anchor.anchor, content);
-        if (!anchorContent)
-            continue;
-        const acceptanceCriteria = extractAcceptanceCriteria(anchorContent);
-        const dependencies = extractDependencies(anchorContent);
-        // Extract first paragraph as description
-        const lines = anchorContent.split("\n").filter((l) => l.trim());
-        const descriptionLines = lines
-            .slice(1)
-            .filter((l) => !l.match(/^#{1,6}\s/) &&
-            !l.match(/^[-*]\s/) &&
-            !l.match(/^\*\*[^*]+\*\*:/) &&
-            l.trim() !== "---");
-        const description = descriptionLines.slice(0, 3).join("\n").trim() ||
-            `Implementation of ${anchor.anchor}`;
-        tasksToCreate.push({
-            title: anchor.headingText.replace(/^#+\s*#[a-z0-9._-]+\s*/i, "").trim() ||
-                anchor.anchor,
-            description,
-            anchor: anchor.anchor,
-            acceptanceCriteria: acceptanceCriteria.length > 0
-                ? acceptanceCriteria
-                : ["Implementation complete", "Tests passing"],
-            dependencies,
-            priority: options.priority || shared_2.TaskPriority.MEDIUM,
-        });
-    }
-    // Display preview
-    console.log(`\nGenerated ${tasksToCreate.length} task(s):\n`);
-    tasksToCreate.forEach((task, index) => {
-        console.log(`${index + 1}. ${task.title}`);
-        console.log(`   Anchor: ${task.anchor}`);
-        console.log(`   Priority: ${task.priority}`);
-        if (task.dependencies.length > 0) {
-            console.log(`   Dependencies: ${task.dependencies.join(", ")}`);
-        }
-        if (options.verbose) {
-            console.log(`   Description: ${task.description}`);
-            console.log(`   Acceptance Criteria:`);
-            task.acceptanceCriteria.forEach((criterion) => {
-                console.log(`     - ${criterion}`);
-            });
-        }
-        console.log();
-    });
-    // Create tasks in database if not dry-run
-    if (!options.dryRun) {
-        if (!options.projectId || !options.specId) {
-            console.error("\nError: --project-id and --spec-id are required for task creation");
-            console.log("Use --dry-run to preview without creating tasks");
-            return 1;
-        }
-        console.log("Connecting to database...");
-        await shared_1.AppDataSource.initialize();
-        try {
-            // Verify project and spec exist
-            const specification = await shared_1.AppDataSource.getRepository(shared_3.Specification).findOne({
-                where: { id: options.specId },
-            });
-            if (!specification) {
-                console.error(`Error: Specification with ID ${options.specId} not found`);
-                return 1;
-            }
-            if (specification.projectId !== options.projectId) {
-                console.error(`Error: Specification belongs to project ${specification.projectId}, not ${options.projectId}`);
-                return 1;
-            }
-            // Create tasks
-            const taskRepository = shared_1.AppDataSource.getRepository(shared_2.Task);
-            const createdTasks = [];
-            for (const taskData of tasksToCreate) {
-                const task = taskRepository.create({
-                    title: taskData.title,
-                    description: taskData.description,
-                    status: shared_2.TaskStatus.OPEN,
-                    priority: taskData.priority,
-                    acceptanceCriteria: taskData.acceptanceCriteria,
-                    dependencies: taskData.dependencies,
-                    specAnchor: taskData.anchor,
-                    specificationId: options.specId,
-                    projectId: options.projectId,
-                });
-                const saved = await taskRepository.save(task);
-                createdTasks.push(saved);
-            }
-            console.log(`\nSuccessfully created ${createdTasks.length} task(s)!`);
-            if (options.verbose) {
-                console.log("\nCreated Task IDs:");
-                createdTasks.forEach((task, index) => {
-                    console.log(`  ${index + 1}. ${task.id} - ${task.title}`);
-                });
-            }
-        }
-        catch (error) {
-            console.error(`\nError creating tasks: ${(0, cli_runtime_1.errorMessage)(error)}`);
-            return 1;
-        }
-        finally {
-            await shared_1.AppDataSource.destroy();
-        }
-    }
-    else {
-        console.log("Dry-run mode: Tasks not created. Use --project-id and --spec-id to create tasks.");
-    }
-    return 0;
-}
-if (require.main === module) {
-    void (0, cli_runtime_1.runCliMain)(main, { errorPrefix: "backlog-generate failed" });
-}

package/dist/backlog-health.d.ts

@@ -1,11 +0,0 @@
-#!/usr/bin/env node
-/**
- * backlog-health CLI Tool
- *
- * Report backlog health metrics.
- *
- * Usage: npm run backlog-health [OPTIONS]
- * Example: npm run backlog-health --project-id=<uuid>
- */
-declare function main(argv?: string[]): Promise<number>;
-export { main };