@spekn/cli 1.0.0 → 1.0.1

package/dist/repo-sync.js

@@ -1,152 +0,0 @@
-#!/usr/bin/env node
-"use strict";
-/**
- * repo-sync CLI command
- *
- * Syncs metadata for the current git repository with Spekn.
- * Looks up the repo by its remote URL and updates name and default branch.
- * Optionally runs AI analysis (same as repo register --analyze).
- * Must be run from inside a local git clone.
- *
- * Usage: spekn repo sync --project-id <uuid> [--analyze] [--agent <name>] [--api-url <url>]
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.runRepoSyncCli = runRepoSyncCli;
-exports.main = main;
-exports.parseArgs = parseArgs;
-const repo_common_1 = require("./repo-common");
-const structured_log_1 = require("./utils/structured-log");
-// ── Help & Args ─────────────────────────────────────────────────────
-function printHelp(stderr) {
-    stderr(`
-repo sync - Sync git repository metadata with Spekn
-
-USAGE:
-  spekn repo sync --project-id <uuid> [options]
-
-OPTIONS:
-  --project-id <uuid>   Project ID that owns the repository (optional if .spekn/context is present)
-  --analyze             Run AI analysis after syncing metadata
-  --agent <name>        Force a specific agent (claude, codex, opencode, etc.)
-  --path <dir>          Repository root path (default: current directory)
-  --dry-run             Discover files only, skip AI analysis
-  --mcp-url <url>       MCP HTTP server URL (default: MCP_HTTP_URL or https://app.spekn.com/mcp)
-  --api-url <url>       API base URL (default: SPEKN_API_URL or https://app.spekn.com)
-  --debug               Show detailed debug output (tokens, HTTP exchanges)
-  --help                Show this help message
-
-ENVIRONMENT:
-  SPEKN_API_URL         API base URL
-  SPEKN_AUTH_TOKEN      Bearer token for authentication
-  SPEKN_ORGANIZATION_ID Organization ID header
-  MCP_HTTP_URL          MCP HTTP server URL (default: https://app.spekn.com/mcp)
-  AGENT_ARGS            Override agent CLI args (skips ACP registry resolution)
-
-DESCRIPTION:
-  Reads the 'origin' remote URL from the current git repository, looks up the
-  matching registered repository in the project, and updates its name and
-  default branch to match the local git state.
-
-  With --analyze, also runs AI-powered analysis to discover specs, assess
-  governance, and create improvement specifications (same as repo register).
-
-EXAMPLES:
-  spekn repo sync --project-id 11111111-1111-4111-8111-111111111111
-  spekn repo sync --project-id 11111111-1111-4111-8111-111111111111 --analyze
-  spekn repo sync --project-id 11111111-1111-4111-8111-111111111111 --analyze --agent claude
-`);
-}
-function parseArgs(args) {
-    const opts = (0, repo_common_1.commonDefaults)(false);
-    for (let i = 0; i < args.length;) {
-        const consumed = (0, repo_common_1.parseCommonFlag)(args, i, opts);
-        if (consumed > 0) {
-            i += consumed;
-            continue;
-        }
-        i++; // skip unknown
-    }
-    return (0, repo_common_1.finalizeOptions)(opts);
-}
-// ── Main ────────────────────────────────────────────────────────────
-async function runRepoSyncCli(args, deps = repo_common_1.defaultDeps) {
-    try {
-        const options = parseArgs(args);
-        (0, structured_log_1.appendCliStructuredLog)({
-            source: "cli.repo.sync",
-            level: "info",
-            message: "Starting repo sync",
-            details: { repoPath: options.repoPath, analyze: options.analyze, apiUrl: options.apiUrl },
-        });
-        const { authToken, organizationId, projectId } = await (0, repo_common_1.resolveAuth)(deps, {
-            projectId: options.projectId,
-            repoPath: options.repoPath,
-        });
-        // ── Phase 1: Sync repository metadata ──────────────────────────
-        const git = (0, repo_common_1.readGitMetadata)(options.repoPath, deps);
-        if (!git)
-            return 1;
-        deps.stdout(`Syncing repository "${git.name}" (${git.remoteUrl})\n`);
-        deps.stdout(`  Default branch : ${git.defaultBranch}\n`);
-        deps.stdout(`  Project        : ${projectId}\n`);
-        const client = (0, repo_common_1.createApiClient)(options.apiUrl, authToken, organizationId);
-        // Find matching repository
-        const repos = 
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        await client.gitRepository.list.query({
-            projectId,
-            limit: 100,
-            offset: 0,
-        });
-        const match = repos.find((r) => r.repositoryUrl === git.remoteUrl);
-        if (!match) {
-            deps.stderr(`Error: No registered repository found for URL "${git.remoteUrl}" in project ${projectId}.\n` +
-                "Use 'spekn repo register' to register this repository first.\n");
-            return 1;
-        }
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        await client.gitRepository.update.mutate({
-            projectId,
-            id: match.id,
-            data: { name: git.name, defaultBranch: git.defaultBranch },
-        });
-        deps.stdout(`Repository synced successfully. ID: ${match.id}\n`);
-        (0, structured_log_1.appendCliStructuredLog)({
-            source: "cli.repo.sync",
-            level: "info",
-            message: "Repository metadata synced",
-            details: { projectId, repositoryId: match.id },
-        });
-        // ── Phase 2: AI analysis (optional) ─────────────────────────────
-        if (!options.analyze)
-            return 0;
-        const exitCode = await (0, repo_common_1.runAnalysisPhase)({ ...options, projectId }, authToken ?? "", deps, organizationId);
-        (0, structured_log_1.appendCliStructuredLog)({
-            source: "cli.repo.sync",
-            level: exitCode === 0 ? "info" : "error",
-            message: "Repo sync completed",
-            details: { exitCode, analyzed: options.analyze, projectId },
-        });
-        return exitCode;
-    }
-    catch (error) {
-        if (error instanceof repo_common_1.HelpRequestedError) {
-            printHelp(deps.stderr);
-            return 0;
-        }
-        deps.stderr(`Error: ${error instanceof Error ? error.message : String(error)}\n`);
-        (0, structured_log_1.appendCliStructuredLog)({
-            source: "cli.repo.sync",
-            level: "error",
-            message: error instanceof Error ? error.message : String(error),
-        });
-        return 1;
-    }
-}
-async function main() {
-    const exitCode = await runRepoSyncCli(process.argv.slice(2));
-    process.exit(exitCode);
-}
-if (require.main === module) {
-    void main();
-}

package/dist/resources/prompt-loader.d.ts

@@ -1 +0,0 @@
-export declare function loadPromptTemplate(name: string): string;

package/dist/resources/prompt-loader.js

@@ -1,62 +0,0 @@
-"use strict";
-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.loadPromptTemplate = loadPromptTemplate;
-const fs = __importStar(require("node:fs"));
-const path = __importStar(require("node:path"));
-const promptCache = new Map();
-function resolvePromptPath(name) {
-    const candidates = [
-        path.resolve(__dirname, "resources", "prompts", name),
-        path.resolve(__dirname, "prompts", name),
-        path.resolve(__dirname, "..", "resources", "prompts", name),
-        path.resolve(process.cwd(), "packages", "cli", "src", "resources", "prompts", name),
-    ];
-    for (const candidate of candidates) {
-        if (fs.existsSync(candidate) && fs.statSync(candidate).isFile()) {
-            return candidate;
-        }
-    }
-    throw new Error(`Prompt resource "${name}" not found. Looked in: ${candidates.join(", ")}`);
-}
-function loadPromptTemplate(name) {
-    const cached = promptCache.get(name);
-    if (cached)
-        return cached;
-    const promptPath = resolvePromptPath(name);
-    const content = fs.readFileSync(promptPath, "utf-8");
-    promptCache.set(name, content);
-    return content;
-}

package/dist/skills-import-local.d.ts

@@ -1,16 +0,0 @@
-/**
- * skills import-local CLI command
- *
- * Imports SKILL.md files from a local directory into a Spekn project.
- *
- * Usage: spekn skills import-local <path> --project-id <uuid> [--namespace <ns>] [--api-url <url>]
- */
-import { CredentialsStore } from "./auth/credentials-store";
-interface Deps {
-    stdout: (content: string) => void;
-    stderr: (content: string) => void;
-    credentialsStore: CredentialsStore;
-}
-export declare function runSkillsImportLocalCli(args: string[], deps?: Deps): Promise<number>;
-export declare function main(): Promise<void>;
-export {};

package/dist/skills-import-local.js

@@ -1,352 +0,0 @@
-"use strict";
-/**
- * skills import-local CLI command
- *
- * Imports SKILL.md files from a local directory into a Spekn project.
- *
- * Usage: spekn skills import-local <path> --project-id <uuid> [--namespace <ns>] [--api-url <url>]
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.runSkillsImportLocalCli = runSkillsImportLocalCli;
-exports.main = main;
-const node_fs_1 = require("node:fs");
-const node_path_1 = require("node:path");
-const client_1 = require("@trpc/client");
-const shared_1 = require("@spekn/shared");
-const credentials_store_1 = require("./auth/credentials-store");
-const project_context_1 = require("./project-context");
-const structured_log_1 = require("./utils/structured-log");
-const trpc_url_1 = require("./utils/trpc-url");
-const help_error_1 = require("./utils/help-error");
-const defaultDeps = {
-    stdout: (content) => process.stdout.write(content),
-    stderr: (content) => process.stderr.write(content),
-    credentialsStore: new credentials_store_1.CredentialsStore(),
-};
-function printHelp(stderr) {
-    stderr(`
-skills import-local - Import SKILL.md files from a local directory
-
-USAGE:
-  spekn skills import-local <path> --project-id <uuid> [options]
-
-ARGUMENTS:
-  <path>                Directory containing SKILL.md files (searched recursively)
-
-OPTIONS:
-  --project-id <uuid>   Project ID to import skills into (optional if .spekn/context is present)
-  --namespace <ns>      Namespace for imported skills (default: directory name)
-  --names <a,b,c>       Comma-separated skill names to import (default: all)
-  --api-url <url>       API base URL (default: SPEKN_API_URL or https://app.spekn.com)
-  --help                Show this help message
-
-ENVIRONMENT:
-  SPEKN_API_URL         API base URL
-  SPEKN_AUTH_TOKEN      Bearer token for authentication
-  SPEKN_ORGANIZATION_ID Organization ID header
-
-EXAMPLES:
-  spekn skills import-local ./my-skills --project-id 11111111-1111-4111-8111-111111111111
-  spekn skills import-local ./plugins/skills --project-id <uuid> --namespace my-org
-`);
-}
-function parseArgs(args) {
-    let path = "";
-    let projectId = "";
-    let namespace = "";
-    let names = [];
-    let apiUrl = process.env.SPEKN_API_URL ?? "https://app.spekn.com";
-    for (let index = 0; index < args.length; index++) {
-        const arg = args[index];
-        if (arg === "--help" || arg === "-h") {
-            throw new help_error_1.HelpRequestedError();
-        }
-        if (arg === "--project-id" && args[index + 1]) {
-            projectId = args[++index];
-            continue;
-        }
-        if (arg?.startsWith("--project-id=")) {
-            projectId = arg.slice("--project-id=".length);
-            continue;
-        }
-        if (arg === "--namespace" && args[index + 1]) {
-            namespace = args[++index];
-            continue;
-        }
-        if (arg?.startsWith("--namespace=")) {
-            namespace = arg.slice("--namespace=".length);
-            continue;
-        }
-        if (arg === "--names" && args[index + 1]) {
-            names = args[++index].split(",").map((n) => n.trim()).filter(Boolean);
-            continue;
-        }
-        if (arg?.startsWith("--names=")) {
-            names = arg.slice("--names=".length).split(",").map((n) => n.trim()).filter(Boolean);
-            continue;
-        }
-        if (arg === "--api-url" && args[index + 1]) {
-            apiUrl = args[++index];
-            continue;
-        }
-        if (arg?.startsWith("--api-url=")) {
-            apiUrl = arg.slice("--api-url=".length);
-            continue;
-        }
-        // Positional argument: path
-        if (!arg?.startsWith("--") && !path) {
-            path = arg;
-        }
-    }
-    if (!path) {
-        throw new Error("Missing required argument: <path>");
-    }
-    const resolvedPath = (0, node_path_1.resolve)(path);
-    if (!namespace) {
-        namespace = (0, node_path_1.basename)(resolvedPath);
-    }
-    return { path: resolvedPath, projectId, namespace, names, apiUrl };
-}
-/**
- * Recursively find all SKILL.md files under a directory.
- */
-function findSkillFiles(dir) {
-    const results = [];
-    const entries = (0, node_fs_1.readdirSync)(dir);
-    for (const entry of entries) {
-        const fullPath = (0, node_path_1.join)(dir, entry);
-        const stat = (0, node_fs_1.statSync)(fullPath);
-        if (stat.isDirectory()) {
-            results.push(...findSkillFiles(fullPath));
-        }
-        else if (entry === "SKILL.md") {
-            results.push(fullPath);
-        }
-    }
-    return results;
-}
-/**
- * Recursively collect all files in a skill directory and return a map
- * of relative paths to file contents.
- */
-function collectSkillFiles(skillDir) {
-    const files = {};
-    function walk(dir) {
-        const entries = (0, node_fs_1.readdirSync)(dir);
-        for (const entry of entries) {
-            const fullPath = (0, node_path_1.join)(dir, entry);
-            const stat = (0, node_fs_1.statSync)(fullPath);
-            if (stat.isDirectory()) {
-                walk(fullPath);
-            }
-            else {
-                const relPath = (0, node_path_1.relative)(skillDir, fullPath);
-                files[relPath] = (0, node_fs_1.readFileSync)(fullPath, "utf-8");
-            }
-        }
-    }
-    walk(skillDir);
-    return files;
-}
-/**
- * Parse a SKILL.md file: extract YAML frontmatter and body content.
- */
-function parseSkillFile(filePath) {
-    const content = (0, node_fs_1.readFileSync)(filePath, "utf-8");
-    const fmMatch = /^---\n([\s\S]*?)\n---/.exec(content);
-    if (!fmMatch?.[1]) {
-        return { error: `${filePath}: no frontmatter found` };
-    }
-    // Simple YAML parsing without js-yaml dependency.
-    // SKILL.md frontmatter is flat key-value, so we parse it manually.
-    const yamlText = fmMatch[1];
-    const frontmatter = {};
-    let currentKey = "";
-    let inNestedMap = false;
-    const nestedMap = {};
-    for (const line of yamlText.split("\n")) {
-        // Nested map value (indented)
-        if (inNestedMap && /^\s{2,}\S/.test(line)) {
-            const kvMatch = /^\s+(\S+):\s*(.*)$/.exec(line);
-            if (kvMatch) {
-                nestedMap[kvMatch[1]] = kvMatch[2].replace(/^["']|["']$/g, "");
-            }
-            continue;
-        }
-        // Flush nested map if we were in one
-        if (inNestedMap) {
-            frontmatter[currentKey] = { ...nestedMap };
-            for (const k of Object.keys(nestedMap))
-                delete nestedMap[k];
-            inNestedMap = false;
-        }
-        // Top-level key: value
-        const topMatch = /^(\S+):\s*(.*)$/.exec(line);
-        if (topMatch) {
-            const key = topMatch[1];
-            const value = topMatch[2].replace(/^["']|["']$/g, "");
-            if (value === "" || value === undefined) {
-                // Could be start of a nested map
-                currentKey = key;
-                inNestedMap = true;
-            }
-            else {
-                frontmatter[key] = value;
-            }
-        }
-    }
-    // Flush last nested map
-    if (inNestedMap) {
-        frontmatter[currentKey] = { ...nestedMap };
-    }
-    // Extract readme (content after frontmatter)
-    const readme = content.slice(fmMatch[0].length).trim();
-    return { frontmatter, readme };
-}
-async function runSkillsImportLocalCli(args, deps = defaultDeps) {
-    try {
-        const options = parseArgs(args);
-        (0, structured_log_1.appendCliStructuredLog)({
-            source: "cli.skills.import-local",
-            level: "info",
-            message: "Starting skills import-local",
-            details: { path: options.path, namespace: options.namespace, apiUrl: options.apiUrl },
-        });
-        // Find SKILL.md files
-        const skillFiles = findSkillFiles(options.path);
-        if (skillFiles.length === 0) {
-            deps.stderr(`No SKILL.md files found under ${options.path}\n`);
-            return 1;
-        }
-        deps.stdout(`Found ${skillFiles.length} SKILL.md file(s) in ${options.path}\n`);
-        // Parse and validate each file
-        const skills = [];
-        const parseErrors = [];
-        for (const filePath of skillFiles) {
-            const result = parseSkillFile(filePath);
-            if ("error" in result) {
-                parseErrors.push(result.error);
-                continue;
-            }
-            const validation = shared_1.SkillFrontmatterSchema.safeParse(result.frontmatter);
-            if (!validation.success) {
-                const issues = validation.error.issues.map((i) => `${i.path.join(".")}: ${i.message}`);
-                parseErrors.push(`${filePath}: ${issues.join("; ")}`);
-                continue;
-            }
-            const fm = validation.data;
-            const meta = fm.metadata;
-            const skillDir = (0, node_path_1.dirname)(filePath);
-            const files = collectSkillFiles(skillDir);
-            skills.push({
-                name: fm.name,
-                description: fm.description,
-                version: meta?.version || "0.0.0",
-                namespace: options.namespace,
-                readme: result.readme || undefined,
-                license: fm.license,
-                compatibility: fm.compatibility,
-                author: meta?.author,
-                tags: [],
-                metadata: meta ? { ...meta } : undefined,
-                files,
-            });
-        }
-        if (parseErrors.length > 0) {
-            deps.stderr(`\nParse errors:\n`);
-            for (const err of parseErrors) {
-                deps.stderr(`  - ${err}\n`);
-            }
-        }
-        // Filter by --names if provided
-        if (options.names.length > 0) {
-            const nameSet = new Set(options.names);
-            const before = skills.length;
-            const filtered = skills.filter((s) => nameSet.has(s.name));
-            skills.length = 0;
-            skills.push(...filtered);
-            if (skills.length < before) {
-                deps.stdout(`Filtered to ${skills.length} of ${before} skill(s) by --names\n`);
-            }
-        }
-        if (skills.length === 0) {
-            deps.stderr(`No valid skills to import.\n`);
-            return 1;
-        }
-        deps.stdout(`\nImporting ${skills.length} skill(s)...\n`);
-        // Auth
-        const storedToken = await deps.credentialsStore.getValidToken();
-        const authToken = storedToken ?? process.env.SPEKN_AUTH_TOKEN;
-        const storedCreds = deps.credentialsStore.load();
-        const context = (0, project_context_1.resolveProjectContext)({
-            explicitProjectId: options.projectId,
-            repoPath: process.cwd(),
-            credentialsOrganizationId: storedCreds?.organizationId,
-            envOrganizationId: process.env.SPEKN_ORGANIZATION_ID,
-        });
-        // tRPC client
-        const client = (0, client_1.createTRPCProxyClient)({
-            links: [
-                (0, client_1.httpBatchLink)({
-                    url: (0, trpc_url_1.normalizeTrpcUrl)(options.apiUrl),
-                    headers: {
-                        "x-organization-id": context.organizationId,
-                        authorization: authToken ? `Bearer ${authToken}` : "",
-                    },
-                }),
-            ],
-        });
-        const result = await client.skills.importLocal.mutate({
-            projectId: context.projectId,
-            skills,
-        });
-        // Report
-        if (result.imported.length > 0) {
-            deps.stdout(`\nImported: ${result.imported.join(", ")}\n`);
-        }
-        if (result.updated.length > 0) {
-            deps.stdout(`Updated: ${result.updated.join(", ")}\n`);
-        }
-        if (result.errors.length > 0) {
-            deps.stderr(`\nServer errors:\n`);
-            for (const err of result.errors) {
-                deps.stderr(`  - ${err}\n`);
-            }
-        }
-        const total = result.imported.length + result.updated.length;
-        deps.stdout(`\nDone. ${total} skill(s) processed.\n`);
-        (0, structured_log_1.appendCliStructuredLog)({
-            source: "cli.skills.import-local",
-            level: result.errors.length > 0 ? "warn" : "info",
-            message: "Skills import-local completed",
-            details: {
-                totalProcessed: total,
-                imported: result.imported.length,
-                updated: result.updated.length,
-                errors: result.errors.length,
-            },
-        });
-        return result.errors.length > 0 ? 1 : 0;
-    }
-    catch (error) {
-        if (error instanceof help_error_1.HelpRequestedError) {
-            printHelp(deps.stderr);
-            return 0;
-        }
-        const message = error instanceof Error ? error.message : String(error);
-        deps.stderr(`Error: ${message}\n`);
-        (0, structured_log_1.appendCliStructuredLog)({
-            source: "cli.skills.import-local",
-            level: "error",
-            message,
-        });
-        return 1;
-    }
-}
-async function main() {
-    const exitCode = await runSkillsImportLocalCli(process.argv.slice(2));
-    process.exit(exitCode);
-}
-if (require.main === module) {
-    void main();
-}

package/dist/spec-drift-check.d.ts

@@ -1,3 +0,0 @@
-#!/usr/bin/env node
-declare function main(argv?: string[]): Promise<number>;
-export { main };