swarmkit 0.0.5 → 0.0.7

package/dist/packages/registry.js

@@ -3,6 +3,28 @@ export const PACKAGES = {
         name: "self-driving-repo",
         description: "Event-driven workflow engine for autonomous GitHub SDLC",
         category: "orchestration",
+        setup: {
+            cliWizard: {
+                command: "sdr",
+                args: ["init"],
+                nonInteractiveArgs: ["init", "-t", "triage-only"],
+                timeout: 180_000,
+            },
+            inlineOptions: [
+                {
+                    key: "template",
+                    label: "Workflow template:",
+                    type: "select",
+                    default: "triage-only",
+                    choices: [
+                        { name: "Triage only — issue triage and labeling", value: "triage-only" },
+                        { name: "Full pipeline — end-to-end SDLC automation", value: "full-pipeline" },
+                        { name: "PR review — automated code review", value: "pr-review" },
+                        { name: "Empty — start from scratch", value: "empty" },
+                    ],
+                },
+            ],
+        },
     },
     "multi-agent-protocol": {
         name: "multi-agent-protocol",
@@ -14,41 +36,203 @@ export const PACKAGES = {
         name: "opentasks",
         description: "Cross-system graph for tasks, specs, and relationships",
         category: "tasks",
+        setup: {
+            cliWizard: {
+                command: "opentasks",
+                args: ["init"],
+            },
+        },
     },
     "cognitive-core": {
         name: "cognitive-core",
         description: "Learning system — trajectories to playbooks to guidance",
         category: "learning",
+        // No setup config — auto-detects minimem at runtime
     },
     minimem: {
         name: "minimem",
         description: "File-based memory with hybrid vector + full-text search",
         category: "learning",
+        setup: {
+            cliWizard: {
+                command: "minimem",
+                args: ["init"],
+            },
+            inlineOptions: [
+                {
+                    key: "hybrid.vectorWeight",
+                    label: "Vector search weight (0-1):",
+                    type: "input",
+                    default: "0.7",
+                },
+                {
+                    key: "hybrid.textWeight",
+                    label: "Text search weight (0-1):",
+                    type: "input",
+                    default: "0.3",
+                },
+                {
+                    key: "query.maxResults",
+                    label: "Max search results:",
+                    type: "input",
+                    default: "10",
+                },
+                {
+                    key: "query.minScore",
+                    label: "Min relevance score (0-1):",
+                    type: "input",
+                    default: "0.3",
+                },
+            ],
+        },
     },
     "skill-tree": {
         name: "skill-tree",
         description: "Versioned skill extraction, evolution, and serving",
         category: "learning",
+        setup: {
+            cliWizard: {
+                command: "skill-tree",
+                args: ["config", "init"],
+            },
+        },
     },
     openhive: {
         name: "openhive",
         description: "Self-hostable social network and coordination hub for agents",
         category: "interface",
+        setup: {
+            cliWizard: {
+                command: "openhive",
+                args: ["init"],
+                nonInteractiveArgs: ["init", "--name", "OpenHive", "--port", "3000",
+                    "--auth-mode", "local", "--verification", "open"],
+                timeout: 180_000,
+            },
+            inlineOptions: [
+                {
+                    key: "name",
+                    label: "OpenHive instance name:",
+                    type: "input",
+                    default: "OpenHive",
+                },
+                {
+                    key: "port",
+                    label: "OpenHive port:",
+                    type: "input",
+                    default: "3000",
+                },
+                {
+                    key: "verification",
+                    label: "Registration mode:",
+                    type: "select",
+                    choices: [
+                        { name: "Open — anyone can register", value: "open" },
+                        { name: "Invite — require an invite code", value: "invite" },
+                        { name: "Manual — admin approves each", value: "manual" },
+                    ],
+                },
+                {
+                    key: "authMode",
+                    label: "Auth mode:",
+                    type: "select",
+                    choices: [
+                        { name: "Local — no login, single-user", value: "local" },
+                        { name: "Token — email/password registration", value: "token" },
+                    ],
+                },
+            ],
+        },
     },
     openteams: {
         name: "openteams",
         description: "Team topology definitions and agent role generation",
         category: "orchestration",
+        setup: {
+            cliWizard: {
+                command: "openteams",
+                args: ["template", "init"],
+            },
+        },
     },
     sessionlog: {
         name: "sessionlog",
         description: "Git-integrated session capture with rewind and search",
         category: "observability",
+        setup: {
+            inlineOptions: [
+                {
+                    key: "enabled",
+                    label: "Enable session logging by default?",
+                    type: "confirm",
+                    default: false,
+                },
+                {
+                    key: "strategy",
+                    label: "Commit strategy:",
+                    type: "select",
+                    default: "manual-commit",
+                    choices: [
+                        { name: "Manual commit — you decide when to save", value: "manual-commit" },
+                        { name: "Auto commit — save after each session", value: "auto-commit" },
+                    ],
+                },
+                {
+                    key: "sessionRepo.remote",
+                    label: "Session repo remote URL (e.g. git@github.com:org/sessions.git, blank to skip):",
+                    type: "input",
+                    default: "",
+                },
+                {
+                    key: "sessionRepo.directory",
+                    label: "Subdirectory in session repo for this project (blank for auto):",
+                    type: "input",
+                    default: "",
+                },
+                {
+                    key: "summarizationEnabled",
+                    label: "Enable session summarization?",
+                    type: "confirm",
+                    default: false,
+                },
+            ],
+        },
     },
     "claude-code-swarm": {
         name: "claude-code-swarm",
         description: "Claude Code plugin for agent team orchestration with openteams templates",
         category: "orchestration",
+        setup: {
+            inlineOptions: [
+                {
+                    key: "map.enabled",
+                    label: "Enable MAP (Multi-Agent Protocol) observability?",
+                    type: "confirm",
+                    default: false,
+                },
+                {
+                    key: "map.server",
+                    label: "MAP server URL:",
+                    type: "input",
+                    default: "ws://localhost:8080",
+                    when: (packages) => packages.includes("multi-agent-protocol"),
+                },
+                {
+                    key: "map.scope",
+                    label: "MAP scope (project identifier):",
+                    type: "input",
+                    default: "",
+                    when: (packages) => packages.includes("multi-agent-protocol"),
+                },
+                {
+                    key: "sessionlog.enabled",
+                    label: "Enable sessionlog bridging?",
+                    type: "confirm",
+                    default: false,
+                    when: (packages) => packages.includes("sessionlog"),
+                },
+            ],
+        },
     },
 };
 export const BUNDLES = {
@@ -93,22 +277,78 @@ export const INTEGRATIONS = [
     {
         packages: ["cognitive-core", "minimem"],
         description: "cognitive-core uses minimem as search layer",
+        requiresWiring: false,
     },
     {
         packages: ["cognitive-core", "skill-tree"],
         description: "skill-tree delegates to cognitive-core for batch learning",
+        requiresWiring: false,
     },
     {
         packages: ["claude-code-swarm", "openteams"],
         description: "claude-code-swarm uses openteams for team topology definitions",
+        requiresWiring: true,
+        configOptions: [
+            {
+                key: "template",
+                label: "Default team template:",
+                type: "input",
+                default: "",
+                targetPackage: "claude-code-swarm",
+                configPath: "template",
+            },
+        ],
     },
     {
         packages: ["claude-code-swarm", "multi-agent-protocol"],
         description: "claude-code-swarm uses MAP for external agent observability",
+        requiresWiring: true,
+        configOptions: [
+            {
+                key: "mapEnabled",
+                label: "Enable MAP observability?",
+                type: "confirm",
+                default: false,
+                targetPackage: "claude-code-swarm",
+                configPath: "map.enabled",
+            },
+            {
+                key: "mapServer",
+                label: "MAP server URL:",
+                type: "input",
+                default: "ws://localhost:8080",
+                targetPackage: "claude-code-swarm",
+                configPath: "map.server",
+            },
+        ],
     },
     {
         packages: ["claude-code-swarm", "sessionlog"],
         description: "claude-code-swarm bridges sessionlog data to MAP via trajectory protocol",
+        requiresWiring: true,
+        configOptions: [
+            {
+                key: "sessionBridging",
+                label: "Enable session data bridging?",
+                type: "confirm",
+                default: false,
+                targetPackage: "claude-code-swarm",
+                configPath: "sessionlog.enabled",
+            },
+            {
+                key: "sessionSync",
+                label: "Session sync mode:",
+                type: "select",
+                default: "off",
+                choices: [
+                    { name: "Off — no syncing", value: "off" },
+                    { name: "On finish — sync when session ends", value: "on-finish" },
+                    { name: "Live — real-time sync", value: "live" },
+                ],
+                targetPackage: "claude-code-swarm",
+                configPath: "sessionlog.sync",
+            },
+        ],
     },
 ];
 /** Get all package names in a bundle */
@@ -152,3 +392,21 @@ export function isKnownPackage(name) {
 export function getAllPackageNames() {
     return Object.keys(PACKAGES);
 }
+/** Category display order for manual package selection */
+export const CATEGORY_ORDER = [
+    "tasks",
+    "learning",
+    "orchestration",
+    "observability",
+    "interface",
+    "protocol",
+];
+/** Human-readable category labels */
+export const CATEGORY_LABELS = {
+    tasks: "Tasks & Planning",
+    learning: "Learning & Memory",
+    orchestration: "Orchestration",
+    observability: "Observability",
+    interface: "Interface",
+    protocol: "Protocol",
+};

package/dist/packages/setup.d.ts

@@ -1,3 +1,5 @@
+import type { PackageSetupConfig } from "./registry.js";
+import type { PackageConfig, WizardState } from "../commands/init/state.js";
 export interface InitContext {
     /** Project root directory */
     cwd: string;
@@ -9,6 +11,8 @@ export interface InitContext {
     apiKeys: Record<string, string>;
     /** Whether to nest project configs under .swarm/ (default true) */
     usePrefix: boolean;
+    /** Per-package config overrides from the interactive config phase */
+    packageConfigs?: Record<string, PackageConfig>;
 }
 export interface GlobalContext {
     /** All selected packages */
@@ -17,6 +21,8 @@ export interface GlobalContext {
     embeddingProvider: "openai" | "gemini" | "local" | null;
     /** Stored API keys */
     apiKeys: Record<string, string>;
+    /** Per-package config overrides from the interactive config phase */
+    packageConfigs?: Record<string, PackageConfig>;
 }
 export interface OpenhiveOptions {
     name: string;
@@ -30,6 +36,37 @@ export interface SetupResult {
     success: boolean;
     message?: string;
 }
+export interface WizardRunOptions {
+    /** Working directory for the spawned process */
+    cwd?: string;
+    /**
+     * When true (default), the wizard takes over the terminal with stdio: "inherit".
+     * When false, runs non-interactively with stdio: "pipe" and uses nonInteractiveArgs
+     * if available. Use false for --quick mode, CI, and testing.
+     */
+    interactive?: boolean;
+}
+/**
+ * Run a package's own setup wizard.
+ *
+ * In interactive mode (default): uses `stdio: 'inherit'` so the package's
+ * prompts take over the terminal.
+ *
+ * In non-interactive mode: uses `stdio: 'pipe'` with `nonInteractiveArgs`
+ * (falling back to `args`), suitable for --quick mode, CI, and testing.
+ */
+export declare function runPackageWizard(pkg: string, wizardConfig: NonNullable<PackageSetupConfig["cliWizard"]>, state: WizardState, opts?: WizardRunOptions | string): Promise<SetupResult>;
+/**
+ * Env var overrides that tell each package's CLI to create config in the
+ * .swarm/<pkg>/ prefix layout instead of the default flat location.
+ * Used by both initProjectPackage (via shellInit) and runPackageWizard.
+ */
+export declare const PREFIX_ENV_VARS: Record<string, string>;
+/**
+ * Flat dir name → prefixed dir name for relocation after CLI wizard runs.
+ * Packages that create at .<name>/ need relocation to .swarm/<name>/.
+ */
+export declare const RELOCATE_MAP: Record<string, [string, string]>;
 /** Root directory for all swarmkit project-level config */
 export declare const PROJECT_ROOT = ".swarm";
 /** Config directories with .swarm/ prefix (default layout) */
@@ -38,6 +75,11 @@ export declare const PROJECT_CONFIG_DIRS: Record<string, string>;
 export declare const FLAT_PROJECT_CONFIG_DIRS: Record<string, string>;
 /** Get config dirs for the given mode */
 export declare function projectConfigDirs(usePrefix: boolean): Record<string, string>;
+/**
+ * After a CLI wizard runs for a project-level package, relocate its output
+ * from the flat location to the .swarm/ prefix location if needed.
+ */
+export declare function relocateAfterWizard(cwd: string, pkg: string, usePrefix: boolean): void;
 /**
  * Project-level packages in correct init order.
  * Order matters: minimem before cognitive-core (runtime detection).