@spekn/cli 1.0.0 → 1.0.1

package/dist/project-context.js

@@ -1,376 +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.findNearestLocalContextFile = findNearestLocalContextFile;
-exports.loadLocalContext = loadLocalContext;
-exports.loadGlobalContext = loadGlobalContext;
-exports.resolveProjectContext = resolveProjectContext;
-exports.getLastUsedProject = getLastUsedProject;
-exports.listRecentProjects = listRecentProjects;
-exports.setLastUsedProject = setLastUsedProject;
-exports.getProjectFromGlobalContext = getProjectFromGlobalContext;
-exports.saveLocalContext = saveLocalContext;
-exports.saveGlobalContext = saveGlobalContext;
-exports.addProjectToGlobalContext = addProjectToGlobalContext;
-exports.ensureGitignoreHasSpekn = ensureGitignoreHasSpekn;
-exports.persistProjectContext = persistProjectContext;
-exports.persistProjectContextWithoutRepoPath = persistProjectContextWithoutRepoPath;
-exports.clearRepoFromGlobalContext = clearRepoFromGlobalContext;
-const fs = __importStar(require("node:fs"));
-const os = __importStar(require("node:os"));
-const path = __importStar(require("node:path"));
-const LOCAL_CONTEXT_FILE = ".spekn";
-const GLOBAL_CONTEXT_PATH = path.join(os.homedir(), ".spekn", "context.json");
-function loadContextFile(filePath) {
-    try {
-        const raw = fs.readFileSync(filePath, "utf-8");
-        const parsed = JSON.parse(raw);
-        if (!parsed || typeof parsed !== "object")
-            return null;
-        return parsed;
-    }
-    catch {
-        return null;
-    }
-}
-function isRoot(dirPath) {
-    return path.dirname(dirPath) === dirPath;
-}
-function findNearestLocalContextFile(startDir = process.cwd()) {
-    let current = path.resolve(startDir);
-    while (true) {
-        const candidate = path.join(current, LOCAL_CONTEXT_FILE);
-        if (fs.existsSync(candidate) && fs.statSync(candidate).isFile()) {
-            return candidate;
-        }
-        if (isRoot(current))
-            return null;
-        current = path.dirname(current);
-    }
-}
-function loadLocalContext(repoPath) {
-    const filePath = repoPath
-        ? path.join(path.resolve(repoPath), LOCAL_CONTEXT_FILE)
-        : findNearestLocalContextFile();
-    if (!filePath)
-        return null;
-    return loadContextFile(filePath);
-}
-function loadGlobalContext() {
-    return loadContextFile(GLOBAL_CONTEXT_PATH);
-}
-function getGlobalProjects(global) {
-    if (!global)
-        return [];
-    return Array.isArray(global.projects) ? global.projects : [];
-}
-function loadGlobalContextWithMigration() {
-    return loadGlobalContext() || {
-        projects: [],
-        updatedAt: new Date().toISOString(),
-    };
-}
-function resolveProjectContext(input) {
-    const local = loadLocalContext(input.repoPath);
-    const global = loadGlobalContextWithMigration();
-    // Priority 1: Explicit project ID
-    const projectId = input.explicitProjectId ??
-        local?.projectId ??
-        // Use last used project from global context if no local context
-        global.lastUsedProjectId ??
-        "";
-    if (!projectId) {
-        throw new Error("Missing project context. Pass --project-id/--project or create a .spekn file in the repository.");
-    }
-    // Priority 2: Organization ID resolution
-    // Order:
-    // 1) explicit org
-    // 2) env org
-    // 3) local .spekn org
-    // 4) global project mapping
-    // 5) global default org
-    // 6) credentials org
-    const organizationId = input.explicitOrganizationId ??
-        input.envOrganizationId ??
-        local?.organizationId ??
-        getGlobalProjects(global).find((p) => p.id === projectId)?.organizationId ??
-        global.defaultOrganizationId ??
-        input.credentialsOrganizationId;
-    if (!organizationId) {
-        throw new Error("Missing organization context. Pass --organization-id, set SPEKN_ORGANIZATION_ID, " +
-            "or run 'spekn auth login' to select an organization.");
-    }
-    return { projectId, organizationId };
-}
-/** Get the most recently used project from global context */
-function getLastUsedProject() {
-    const global = loadGlobalContextWithMigration();
-    const lastUsedId = global.lastUsedProjectId;
-    if (!lastUsedId)
-        return null;
-    const project = getGlobalProjects(global).find(p => p.id === lastUsedId);
-    if (project) {
-        return {
-            projectId: project.id,
-            organizationId: project.organizationId
-        };
-    }
-    return null;
-}
-/** List all recent projects from global context */
-function listRecentProjects() {
-    const global = loadGlobalContextWithMigration();
-    return getGlobalProjects(global).sort((a, b) => new Date(b.lastUsed).getTime() - new Date(a.lastUsed).getTime()) || [];
-}
-/** Set the last used project in global context */
-function setLastUsedProject(projectId) {
-    const global = loadGlobalContextWithMigration();
-    // Only update if the project exists in our history
-    if (getGlobalProjects(global).some(p => p.id === projectId)) {
-        saveGlobalContext({
-            ...global,
-            lastUsedProjectId: projectId,
-            updatedAt: new Date().toISOString()
-        });
-    }
-}
-/** Get project by ID from global context */
-function getProjectFromGlobalContext(projectId) {
-    const global = loadGlobalContextWithMigration();
-    return getGlobalProjects(global).find(p => p.id === projectId) || null;
-}
-function saveLocalContext(repoPath, context) {
-    const filePath = path.join(path.resolve(repoPath), LOCAL_CONTEXT_FILE);
-    const content = {
-        projectId: context.projectId,
-        organizationId: context.organizationId,
-        updatedAt: new Date().toISOString(),
-    };
-    fs.writeFileSync(filePath, JSON.stringify(content, null, 2) + "\n", "utf-8");
-}
-function saveGlobalContext(context) {
-    const dirPath = path.dirname(GLOBAL_CONTEXT_PATH);
-    fs.mkdirSync(dirPath, { recursive: true, mode: 0o700 });
-    // Ensure we have required fields
-    const content = {
-        projects: context.projects || getGlobalProjects(context),
-        lastUsedProjectId: context.lastUsedProjectId,
-        defaultOrganizationId: context.defaultOrganizationId,
-        preferences: context.preferences,
-        repoSync: context.repoSync,
-        updatedAt: context.updatedAt || new Date().toISOString(),
-    };
-    fs.writeFileSync(GLOBAL_CONTEXT_PATH, JSON.stringify(content, null, 2) + "\n", {
-        encoding: "utf-8",
-        mode: 0o600,
-    });
-}
-/** Add or update a project in the global context history */
-function addProjectToGlobalContext(projectId, organizationId, repoPath) {
-    const globalContext = loadGlobalContextWithMigration();
-    // Find existing project or create new
-    let projectFound = false;
-    const updatedProjects = getGlobalProjects(globalContext).map(p => {
-        if (p.id === projectId) {
-            projectFound = true;
-            return {
-                ...p,
-                lastUsed: new Date().toISOString(),
-                repoPaths: Array.from(new Set([...(p.repoPaths || []), repoPath]))
-            };
-        }
-        return p;
-    }) || [];
-    // Add new project if not found
-    if (!projectFound) {
-        updatedProjects.unshift({
-            id: projectId,
-            organizationId,
-            lastUsed: new Date().toISOString(),
-            repoPaths: [repoPath]
-        });
-    }
-    // Keep only last 10 projects to avoid unlimited growth
-    const projects = updatedProjects.slice(0, 10);
-    // Update global context
-    saveGlobalContext({
-        ...globalContext,
-        projects,
-        lastUsedProjectId: projectId,
-        defaultOrganizationId: organizationId,
-        updatedAt: new Date().toISOString()
-    });
-}
-function ensureGitignoreHasSpekn(repoPath) {
-    const gitignorePath = path.join(path.resolve(repoPath), ".gitignore");
-    const entry = ".spekn";
-    if (!fs.existsSync(gitignorePath)) {
-        fs.writeFileSync(gitignorePath, `${entry}\n`, "utf-8");
-        return;
-    }
-    const content = fs.readFileSync(gitignorePath, "utf-8");
-    const lines = content.split(/\r?\n/);
-    if (lines.some((line) => line.trim() === entry))
-        return;
-    const needsNewline = content.length > 0 && !content.endsWith("\n");
-    const toAppend = `${needsNewline ? "\n" : ""}${entry}\n`;
-    fs.appendFileSync(gitignorePath, toAppend, "utf-8");
-}
-function persistProjectContext(repoPath, context) {
-    // Save local context (repository-specific)
-    saveLocalContext(repoPath, context);
-    // Add to global context history (multi-project support)
-    if (context.organizationId) {
-        addProjectToGlobalContext(context.projectId, context.organizationId, repoPath);
-    }
-}
-function persistProjectContextWithoutRepoPath(repoPath, context) {
-    // Keep local repository selection, but do not append repoPaths globally.
-    saveLocalContext(repoPath, context);
-    const globalContext = loadGlobalContextWithMigration();
-    const now = new Date().toISOString();
-    const organizationId = context.organizationId ?? globalContext.defaultOrganizationId ?? "";
-    const projects = getGlobalProjects(globalContext);
-    const updatedProjects = projects.map((project) => project.id === context.projectId
-        ? {
-            ...project,
-            organizationId: organizationId || project.organizationId,
-            lastUsed: now,
-        }
-        : project);
-    if (!updatedProjects.some((project) => project.id === context.projectId) &&
-        organizationId) {
-        updatedProjects.unshift({
-            id: context.projectId,
-            organizationId,
-            lastUsed: now,
-            repoPaths: [],
-        });
-    }
-    saveGlobalContext({
-        ...globalContext,
-        projects: updatedProjects.slice(0, 10),
-        lastUsedProjectId: context.projectId,
-        defaultOrganizationId: organizationId || globalContext.defaultOrganizationId,
-        updatedAt: now,
-    });
-}
-function clearRepoFromGlobalContext(repoPath, projectId) {
-    const globalContext = loadGlobalContext();
-    if (!globalContext) {
-        return {
-            removedProjectRefs: 0,
-            removedSyncCheckpoints: 0,
-            removedProjects: 0,
-            clearedLastUsedProjectId: false,
-        };
-    }
-    const normalizedRepoPath = path.resolve(repoPath);
-    let removedProjectRefs = 0;
-    let removedSyncCheckpoints = 0;
-    let removedProjects = 0;
-    const retainedProjects = getGlobalProjects(globalContext)
-        .map((project) => {
-        const repoPaths = (project.repoPaths || []).filter((entryPath) => {
-            const shouldKeep = path.resolve(entryPath) !== normalizedRepoPath;
-            if (!shouldKeep)
-                removedProjectRefs += 1;
-            return shouldKeep;
-        });
-        const checkpoints = { ...(project.repoSync?.checkpoints ?? {}) };
-        for (const checkpointPath of Object.keys(checkpoints)) {
-            if (path.resolve(checkpointPath) === normalizedRepoPath) {
-                delete checkpoints[checkpointPath];
-                removedSyncCheckpoints += 1;
-            }
-        }
-        return {
-            ...project,
-            repoPaths,
-            repoSync: {
-                ...(project.repoSync ?? {}),
-                checkpoints,
-            },
-        };
-    })
-        .filter((project) => {
-        if (projectId && project.id === projectId) {
-            removedProjects += 1;
-            return false;
-        }
-        const hasRepoPaths = (project.repoPaths ?? []).length > 0;
-        const hasCheckpoints = Object.keys(project.repoSync?.checkpoints ?? {}).length > 0;
-        if (!hasRepoPaths && !hasCheckpoints) {
-            removedProjects += 1;
-            return false;
-        }
-        return true;
-    });
-    const removedProjectIds = new Set(getGlobalProjects(globalContext)
-        .filter((project) => !retainedProjects.some((candidate) => candidate.id === project.id))
-        .map((project) => project.id));
-    const globalCheckpoints = { ...(globalContext.repoSync?.checkpoints ?? {}) };
-    for (const checkpointPath of Object.keys(globalCheckpoints)) {
-        if (path.resolve(checkpointPath) === normalizedRepoPath) {
-            delete globalCheckpoints[checkpointPath];
-            removedSyncCheckpoints += 1;
-        }
-    }
-    const shouldClearLastUsed = !!globalContext.lastUsedProjectId && removedProjectIds.has(globalContext.lastUsedProjectId);
-    if (removedProjectRefs === 0 &&
-        removedSyncCheckpoints === 0 &&
-        removedProjects === 0 &&
-        !shouldClearLastUsed) {
-        return {
-            removedProjectRefs: 0,
-            removedSyncCheckpoints: 0,
-            removedProjects: 0,
-            clearedLastUsedProjectId: false,
-        };
-    }
-    saveGlobalContext({
-        ...globalContext,
-        projects: retainedProjects,
-        lastUsedProjectId: shouldClearLastUsed ? undefined : globalContext.lastUsedProjectId,
-        repoSync: Object.keys(globalCheckpoints).length > 0 ? { checkpoints: globalCheckpoints } : undefined,
-        updatedAt: new Date().toISOString(),
-    });
-    return {
-        removedProjectRefs,
-        removedSyncCheckpoints,
-        removedProjects,
-        clearedLastUsedProjectId: shouldClearLastUsed,
-    };
-}

package/dist/repo-common.d.ts

@@ -1,101 +0,0 @@
-/**
- * Shared utilities for repo register / repo sync CLI commands.
- *
- * Extracts common concerns: deps, auth, git metadata, tRPC client,
- * file discovery display, and the full analysis phase.
- */
-import { CredentialsStore } from "./auth/credentials-store";
-import { HelpRequestedError } from "./utils/help-error";
-export interface Deps {
-    execGit: (args: string[]) => string;
-    stdout: (content: string) => void;
-    stderr: (content: string) => void;
-    credentialsStore: CredentialsStore;
-}
-export declare const defaultDeps: Deps;
-/** Fields common to both register and sync CLI options. */
-export interface CommonOptions {
-    projectId: string;
-    apiUrl: string;
-    analyze: boolean;
-    agent: string | null;
-    repoPath: string;
-    dryRun: boolean;
-    mcpUrl: string;
-    debug: boolean;
-}
-export interface DiscoveredFile {
-    relativePath: string;
-    absolutePath: string;
-    category: "governance" | "spec" | "decision" | "config";
-}
-export { HelpRequestedError };
-/**
- * Parse flags shared by both register and sync. Returns consumed arg
- * count (0 if the flag was not recognized). Mutates `out` in place.
- */
-export declare function parseCommonFlag(args: string[], index: number, out: CommonOptions): number;
-export declare function commonDefaults(analyzeDefault: boolean): CommonOptions;
-export declare function finalizeOptions<T extends CommonOptions>(opts: T): T;
-export declare function resolveAuth(deps: Deps, options?: {
-    projectId?: string;
-    repoPath?: string;
-}): Promise<{
-    authToken: string | undefined;
-    organizationId: string;
-    projectId: string;
-}>;
-export declare function createApiClient(apiUrl: string, authToken: string | undefined, organizationId: string): any;
-export declare function repoNameFromUrl(url: string): string;
-export declare function resolveDefaultBranch(execGit: Deps["execGit"]): string;
-export declare function readGitMetadata(repoPath: string, deps: Deps): {
-    remoteUrl: string;
-    name: string;
-    defaultBranch: string;
-} | null;
-export declare function discoverFiles(repoPath: string): DiscoveredFile[];
-/** Discover files, print summary. Returns files or null if empty. */
-export declare function discoverAndDisplay(repoPath: string, stdout: (s: string) => void): DiscoveredFile[] | null;
-export declare function buildAnalysisPrompt(projectId: string, repoPath: string, files: DiscoveredFile[], organizationId?: string): string;
-export declare function validateAnalysisReport(text: string): {
-    ok: boolean;
-    missing: string[];
-};
-/**
- * Connect to the MCP HTTP server via raw JSON-RPC, perform the MCP
- * initialize handshake, then list tools and verify Spekn tools exist.
- * Returns tool names on success or null on failure.
- */
-export declare function verifyMcpServer(mcpUrl: string, authToken: string, stderr: (s: string) => void, debug: boolean, sessionPurpose?: string): Promise<string[] | null>;
-export declare function executeAcpSession(agent: {
-    command: string;
-    args: string[];
-}, prompt: string, repoPath: string, mcpUrl: string, authToken: string, stderr: (s: string) => void, organizationId?: string, sessionPurpose?: string): Promise<{
-    text: string;
-    error?: string;
-}>;
-export interface AnalysisOptions {
-    apiUrl: string;
-    agentName: string | null;
-    prompt: string;
-    repoPath: string;
-    mcpUrl: string;
-    authToken: string;
-    organizationId?: string;
-    stdout: (s: string) => void;
-    stderr: (s: string) => void;
-    debug: boolean;
-}
-/**
- * Verify MCP server, resolve an agent, run the ACP session.
- * Retries with the next agent if one doesn't support HTTP MCP.
- */
-export declare function runAnalysisWithAgent(options: AnalysisOptions): Promise<{
-    text: string;
-    error?: string;
-}>;
-/**
- * Complete analysis phase: discover files → build prompt → run agent.
- * Returns exit code (0 = success, 1 = error).
- */
-export declare function runAnalysisPhase(options: CommonOptions, authToken: string, deps: Deps, organizationId?: string): Promise<number>;