@synergenius/flow-weaver 0.33.1 → 0.44.0

package/dist/cli/pack-commands.js

@@ -1,122 +0,0 @@
-/**
- * Registers CLI commands contributed by installed marketplace packs.
- *
- * Scans for packs with cliCommands in their manifest. For each pack,
- * registers a Commander subcommand group under the pack namespace
- * (e.g., @synergenius/flow-weaver-pack-weaver -> "weaver").
- *
- * Command handlers are lazy: the pack's cliEntrypoint is only imported
- * when the user actually invokes a pack command.
- */
-import * as path from 'path';
-import { pathToFileURL } from 'node:url';
-import { listInstalledPackages } from '../marketplace/registry.js';
-import { VERSION } from '../generated-version.js';
-function compareVersions(a, b) {
-    const pa = a.split('.').map(Number);
-    const pb = b.split('.').map(Number);
-    for (let i = 0; i < 3; i++) {
-        const diff = (pa[i] ?? 0) - (pb[i] ?? 0);
-        if (diff !== 0)
-            return diff;
-    }
-    return 0;
-}
-function checkPackEngineVersion(pkg) {
-    const required = pkg.manifest.engineVersion;
-    if (!required)
-        return;
-    const minVersion = required.replace(/^>=?\s*/, '');
-    const current = VERSION;
-    if (compareVersions(current, minVersion) < 0) {
-        console.warn(`\x1b[33mWarning: ${pkg.name} requires flow-weaver >=${minVersion} but ${current} is installed.\x1b[0m`);
-        console.warn(`\x1b[33mRun: npm install @synergenius/flow-weaver@latest\x1b[0m`);
-    }
-}
-/**
- * Derive a short namespace from a pack's npm name.
- * @synergenius/flow-weaver-pack-weaver -> weaver
- * flow-weaver-pack-gitlab-ci -> gitlab-ci
- */
-function deriveNamespace(packageName) {
-    const base = packageName.replace(/^@[^/]+\//, '');
-    return base.replace(/^flow-weaver-pack-/, '');
-}
-export async function registerPackCommands(program) {
-    const projectDir = process.cwd();
-    let packages;
-    try {
-        packages = await listInstalledPackages(projectDir);
-    }
-    catch {
-        return;
-    }
-    for (const pkg of packages) {
-        const manifest = pkg.manifest;
-        if (!manifest.cliEntrypoint || !manifest.cliCommands?.length)
-            continue;
-        checkPackEngineVersion(pkg);
-        const namespace = deriveNamespace(pkg.name);
-        const entrypointPath = path.join(pkg.path, manifest.cliEntrypoint);
-        const group = program
-            .command(namespace)
-            .description(`Commands from ${pkg.name}`);
-        // Override Commander's auto-generated help with the pack's grouped help.
-        // Intercept both bare `weaver` (action) and `weaver --help` (helpCommand).
-        const showPackHelp = async () => {
-            try {
-                const bridge = await import(pathToFileURL(entrypointPath).href);
-                if (typeof bridge.printHelp === 'function') {
-                    bridge.printHelp();
-                    return;
-                }
-            }
-            catch { /* fall through */ }
-            group.outputHelp();
-        };
-        group.action(showPackHelp);
-        group.command('help').description('Show help').action(showPackHelp);
-        group.helpOption(false); // disable --help so it doesn't trigger Commander's default
-        group.option('-h, --help', 'Show help');
-        group.hook('preAction', async (thisCmd) => {
-            if (thisCmd.opts().help) {
-                await showPackHelp();
-                process.exit(0);
-            }
-        });
-        for (const cmd of manifest.cliCommands) {
-            const sub = group
-                .command(cmd.name)
-                .description(cmd.description);
-            if (cmd.usage) {
-                sub.argument(cmd.usage);
-            }
-            if (cmd.options) {
-                for (const opt of cmd.options) {
-                    if (opt.default !== undefined) {
-                        sub.option(opt.flags, opt.description, String(opt.default));
-                    }
-                    else {
-                        sub.option(opt.flags, opt.description);
-                    }
-                }
-            }
-            // Lazy handler: only import the pack's bridge when invoked
-            sub.allowUnknownOption(true);
-            sub.action(async (...actionArgs) => {
-                try {
-                    const bridge = await import(pathToFileURL(entrypointPath).href);
-                    // Collect raw args from the sub command
-                    const rawArgs = sub.args ?? [];
-                    await bridge.handleCommand(cmd.name, rawArgs);
-                }
-                catch (err) {
-                    const msg = err instanceof Error ? err.message : String(err);
-                    console.error(`Error running ${namespace} ${cmd.name}: ${msg}`);
-                    process.exit(1);
-                }
-            });
-        }
-    }
-}
-//# sourceMappingURL=pack-commands.js.map

package/dist/cli/postinstall.d.ts

@@ -1,16 +0,0 @@
-/**
- * Postinstall welcome message.
- *
- * Context-aware, shown once after npm install.
- * Silent in CI. No telemetry, no file modifications, no dark patterns.
- */
-export type InstallContext = 'ci' | 'global' | 'typescript' | 'existing' | 'project';
-/**
- * Detect the installation context based on cwd and environment variables.
- */
-export declare function detectContext(cwd: string, env: Record<string, string | undefined>): InstallContext;
-/**
- * Format the welcome message for the detected context.
- */
-export declare function formatMessage(context: InstallContext): string;
-//# sourceMappingURL=postinstall.d.ts.map

package/dist/cli/postinstall.js

@@ -1,119 +0,0 @@
-/**
- * Postinstall welcome message.
- *
- * Context-aware, shown once after npm install.
- * Silent in CI. No telemetry, no file modifications, no dark patterns.
- */
-import * as fs from 'fs';
-import * as path from 'path';
-const CI_ENV_VARS = ['CI', 'CONTINUOUS_INTEGRATION', 'BUILD_NUMBER', 'GITHUB_ACTIONS', 'GITLAB_CI', 'CIRCLECI', 'JENKINS_URL', 'CODEBUILD_BUILD_ID'];
-/**
- * Scan .ts files in a directory (non-recursive) for @flowWeaver annotations.
- */
-function dirHasFlowWeaver(dir) {
-    try {
-        const entries = fs.readdirSync(dir);
-        for (const entry of entries) {
-            if (!entry.endsWith('.ts') || entry.endsWith('.d.ts'))
-                continue;
-            try {
-                const content = fs.readFileSync(path.join(dir, entry), 'utf8');
-                if (content.includes('@flowWeaver'))
-                    return true;
-            }
-            catch {
-                // Permission error or similar — skip
-            }
-        }
-    }
-    catch {
-        // Directory doesn't exist or can't be read
-    }
-    return false;
-}
-/**
- * Scan .ts files in a directory (non-recursive) for existence.
- */
-function dirHasTsFiles(dir) {
-    try {
-        const entries = fs.readdirSync(dir);
-        return entries.some((e) => e.endsWith('.ts') && !e.endsWith('.d.ts'));
-    }
-    catch {
-        return false;
-    }
-}
-/**
- * Detect the installation context based on cwd and environment variables.
- */
-export function detectContext(cwd, env) {
-    // CI — always silent
-    if (CI_ENV_VARS.some((v) => env[v])) {
-        return 'ci';
-    }
-    // No package.json — likely global install or outside a project
-    if (!fs.existsSync(path.join(cwd, 'package.json'))) {
-        return 'global';
-    }
-    // Check for TypeScript project (tsconfig.json as proxy)
-    const hasTsConfig = fs.existsSync(path.join(cwd, 'tsconfig.json'));
-    if (!hasTsConfig) {
-        return 'project';
-    }
-    // Check for existing @flowWeaver usage (top-level and src/ only)
-    if (dirHasFlowWeaver(cwd) || dirHasFlowWeaver(path.join(cwd, 'src'))) {
-        return 'existing';
-    }
-    // TypeScript project without @flowWeaver
-    if (dirHasTsFiles(cwd) || dirHasTsFiles(path.join(cwd, 'src'))) {
-        return 'typescript';
-    }
-    // Has tsconfig but no .ts files yet
-    return 'typescript';
-}
-/**
- * Format the welcome message for the detected context.
- */
-export function formatMessage(context) {
-    switch (context) {
-        case 'ci':
-            return '';
-        case 'global':
-            return [
-                '',
-                '  flow-weaver installed \u2713',
-                '',
-                '  Create a project:  fw init my-project',
-                '  Or try it now:     fw create workflow hello-world',
-                '',
-            ].join('\n');
-        case 'typescript':
-            return [
-                '',
-                '  flow-weaver installed \u2713',
-                '',
-                '  Add above any function:  /** @flowWeaver nodeType */',
-                '  Then compile:            fw compile src/',
-                '',
-            ].join('\n');
-        case 'existing':
-            return [
-                '',
-                '  flow-weaver updated \u2713',
-                '',
-                '  Check health:  fw doctor',
-                '',
-            ].join('\n');
-        case 'project':
-            return [
-                '',
-                '  flow-weaver installed \u2713',
-                '',
-                '  Get started:  fw init',
-                '',
-            ].join('\n');
-    }
-}
-// Entry point logic lives in scripts/postinstall.cjs (standalone CJS, no build step).
-// This module is the testable source of truth for the detection/formatting logic.
-//# sourceMappingURL=postinstall.js.map

package/dist/cli/templates/ai/mock-provider.js

@@ -1,64 +0,0 @@
-export const createMockProvider = () => ({
-    async chat(messages, options) {
-        const lastMessage = messages[messages.length - 1];
-        // Simulate tool calling if tools provided
-        if (options?.tools && options.tools.length > 0) {
-            const shouldCallTool = lastMessage.content.toLowerCase().includes('search') ||
-                lastMessage.content.toLowerCase().includes('calculate');
-            if (shouldCallTool) {
-                return {
-                    content: null,
-                    toolCalls: [
-                        {
-                            id: `call_${Date.now()}`,
-                            name: options.tools[0].name,
-                            arguments: { query: lastMessage.content },
-                        },
-                    ],
-                    finishReason: 'tool_calls',
-                };
-            }
-        }
-        return {
-            content: `[Mock Response to: ${lastMessage.content.slice(0, 50)}...]`,
-            toolCalls: [],
-            finishReason: 'stop',
-        };
-    },
-});
-// Example real provider adapter (in comments for user reference)
-/*
-import OpenAI from 'openai';
-
-export const createOpenAIProvider = (apiKey: string): LLMProvider => {
-  const client = new OpenAI({ apiKey });
-
-  return {
-    async chat(messages, options) {
-      const response = await client.chat.completions.create({
-        model: options?.model ?? 'gpt-4',
-        messages: messages.map(m => ({ role: m.role, content: m.content })),
-        tools: options?.tools?.map(t => ({ type: 'function', function: t })),
-        temperature: options?.temperature,
-        max_tokens: options?.maxTokens,
-      });
-
-      const choice = response.choices[0];
-      return {
-        content: choice.message.content,
-        toolCalls: choice.message.tool_calls?.map(tc => ({
-          id: tc.id,
-          name: tc.function.name,
-          arguments: JSON.parse(tc.function.arguments)
-        })) ?? [],
-        finishReason: choice.finish_reason as any,
-        usage: response.usage ? {
-          promptTokens: response.usage.prompt_tokens,
-          completionTokens: response.usage.completion_tokens
-        } : undefined
-      };
-    }
-  };
-};
-*/
-//# sourceMappingURL=mock-provider.js.map

package/dist/cli/templates/ai/types.js

@@ -1,5 +0,0 @@
-/**
- * Provider-agnostic LLM types for Flow Weaver AI templates
- */
-export {};
-//# sourceMappingURL=types.js.map

package/dist/cli/templates/approvals/index.d.ts

@@ -1,15 +0,0 @@
-/**
- * Approval Strategy Code Generators
- * Generate approval provider implementation code for different strategies.
- *
- * Mirrors the LLM provider pattern in providers/index.ts.
- */
-export declare function generateMockApproval(): string;
-export declare function generateCallbackApproval(): string;
-export declare function generateWebhookApproval(): string;
-/**
- * Get approval provider code for a given strategy.
- * Mirrors getProviderCode() from providers/index.ts.
- */
-export declare function getApprovalCode(strategy: string): string;
-//# sourceMappingURL=index.d.ts.map

package/dist/cli/templates/approvals/index.js

@@ -1,241 +0,0 @@
-/**
- * Approval Strategy Code Generators
- * Generate approval provider implementation code for different strategies.
- *
- * Mirrors the LLM provider pattern in providers/index.ts.
- */
-export function generateMockApproval() {
-    return `/* ============================================================
- * MOCK APPROVAL PROVIDER (For Testing)
- * Auto-approves all requests. Replace with a real strategy for production.
- * ============================================================ */
-
-const _defaultApprovalProvider: ApprovalProvider = {
-  async requestApproval(request) {
-    console.log('[Mock Approval] Auto-approving:', request.prompt);
-    return {
-      approved: true,
-      response: 'Auto-approved (mock)',
-      reviewer: 'system',
-    };
-  },
-};
-
-const approvalProvider: ApprovalProvider = (globalThis as unknown as { __fw_approval_provider__?: ApprovalProvider }).__fw_approval_provider__ ?? _defaultApprovalProvider;`;
-}
-export function generateCallbackApproval() {
-    return `/* ============================================================
- * CALLBACK APPROVAL PROVIDER
- *
- * Pauses the workflow on a Promise. Call resolveApproval() from
- * your HTTP handler, webhook, or external system to resume.
- *
- * Example integration:
- *   app.post('/approve/:id', (req, res) => {
- *     resolveApproval(req.params.id, true, req.body.response, req.body.reviewer);
- *     res.json({ ok: true });
- *   });
- * ============================================================ */
-
-const _pendingApprovals = new Map<string, {
-  resolve: (result: ApprovalResult) => void;
-  request: ApprovalRequest;
-  createdAt: number;
-}>();
-
-/**
- * Resolve a pending approval. Call this from your HTTP handler or external system.
- * Returns true if the approval was found and resolved, false if not found.
- */
-function resolveApproval(
-  id: string,
-  approved: boolean,
-  response?: string,
-  reviewer?: string,
-): boolean {
-  const pending = _pendingApprovals.get(id);
-  if (!pending) return false;
-  pending.resolve({ approved, response, reviewer });
-  _pendingApprovals.delete(id);
-  return true;
-}
-
-/** Get all currently pending approval requests */
-function getPendingApprovals(): Array<{ id: string; request: ApprovalRequest; createdAt: number }> {
-  return [..._pendingApprovals.entries()].map(([id, entry]) => ({
-    id,
-    request: entry.request,
-    createdAt: entry.createdAt,
-  }));
-}
-
-const _defaultApprovalProvider: ApprovalProvider = {
-  async requestApproval(request) {
-    const id = request.id || crypto.randomUUID();
-    console.log(\`[Approval] Waiting for approval: \${id} — "\${request.prompt}"\`);
-
-    return new Promise<ApprovalResult>((resolve) => {
-      _pendingApprovals.set(id, { resolve, request, createdAt: Date.now() });
-
-      // Set up timeout if specified
-      if (request.timeout) {
-        const ms = parseTimeout(request.timeout);
-        if (ms > 0) {
-          setTimeout(() => {
-            if (_pendingApprovals.has(id)) {
-              _pendingApprovals.delete(id);
-              resolve({ approved: false, response: 'Timed out' });
-            }
-          }, ms);
-        }
-      }
-    });
-  },
-};
-
-/** Parse timeout string like "7d", "24h", "30m" to milliseconds */
-function parseTimeout(timeout: string): number {
-  const match = timeout.match(/^(\\d+)\\s*(ms|s|m|h|d)$/);
-  if (!match) return 0;
-  const value = parseInt(match[1], 10);
-  const unit = match[2];
-  const multipliers: Record<string, number> = { ms: 1, s: 1000, m: 60000, h: 3600000, d: 86400000 };
-  return value * (multipliers[unit] ?? 0);
-}
-
-const approvalProvider: ApprovalProvider = (globalThis as unknown as { __fw_approval_provider__?: ApprovalProvider }).__fw_approval_provider__ ?? _defaultApprovalProvider;`;
-}
-export function generateWebhookApproval() {
-    return `/* ============================================================
- * WEBHOOK APPROVAL PROVIDER
- *
- * Extends the callback pattern with a ready-made request handler.
- * Mount createApprovalHandler() in your HTTP framework:
- *
- *   Express:  app.use('/approvals', createApprovalHandler());
- *   Hono:     app.route('/approvals', createApprovalHandler());
- *   Node.js:  http.createServer(createApprovalHandler());
- *
- * Endpoints:
- *   POST /approve/:id  — Approve a request  (body: { response?, reviewer? })
- *   POST /reject/:id   — Reject a request   (body: { response?, reviewer? })
- *   GET  /pending       — List pending approvals
- * ============================================================ */
-
-const _pendingApprovals = new Map<string, {
-  resolve: (result: ApprovalResult) => void;
-  request: ApprovalRequest;
-  createdAt: number;
-}>();
-
-function resolveApproval(
-  id: string,
-  approved: boolean,
-  response?: string,
-  reviewer?: string,
-): boolean {
-  const pending = _pendingApprovals.get(id);
-  if (!pending) return false;
-  pending.resolve({ approved, response, reviewer });
-  _pendingApprovals.delete(id);
-  return true;
-}
-
-function getPendingApprovals(): Array<{ id: string; request: ApprovalRequest; createdAt: number }> {
-  return [..._pendingApprovals.entries()].map(([id, entry]) => ({
-    id,
-    request: entry.request,
-    createdAt: entry.createdAt,
-  }));
-}
-
-/** Parse timeout string like "7d", "24h", "30m" to milliseconds */
-function parseTimeout(timeout: string): number {
-  const match = timeout.match(/^(\\d+)\\s*(ms|s|m|h|d)$/);
-  if (!match) return 0;
-  const value = parseInt(match[1], 10);
-  const unit = match[2];
-  const multipliers: Record<string, number> = { ms: 1, s: 1000, m: 60000, h: 3600000, d: 86400000 };
-  return value * (multipliers[unit] ?? 0);
-}
-
-/**
- * Creates an HTTP request handler for approval webhooks.
- * Returns a function compatible with Node.js http.createServer(),
- * or mount it as middleware in Express/Hono/Fastify.
- */
-function createApprovalHandler(): (req: { method?: string; url?: string; }, res: { writeHead: (status: number, headers?: Record<string, string>) => void; end: (body?: string) => void; }) => Promise<void> {
-  return async (req, res) => {
-    const url = req.url ?? '';
-    const method = req.method ?? 'GET';
-
-    // GET /pending
-    if (method === 'GET' && url.match(/\\/pending\\/?$/)) {
-      res.writeHead(200, { 'Content-Type': 'application/json' });
-      res.end(JSON.stringify({ pending: getPendingApprovals() }));
-      return;
-    }
-
-    // POST /approve/:id or POST /reject/:id
-    const match = url.match(/\\/(approve|reject)\\/([^/?]+)/);
-    if (method === 'POST' && match) {
-      const [, action, id] = match;
-      const resolved = resolveApproval(
-        id,
-        action === 'approve',
-        undefined,
-        undefined,
-      );
-      res.writeHead(resolved ? 200 : 404, { 'Content-Type': 'application/json' });
-      res.end(JSON.stringify({ resolved, id, action }));
-      return;
-    }
-
-    res.writeHead(404);
-    res.end('Not found');
-  };
-}
-
-const _defaultApprovalProvider: ApprovalProvider = {
-  async requestApproval(request) {
-    const id = request.id || crypto.randomUUID();
-    console.log(\`[Approval Webhook] Waiting for approval: \${id} — "\${request.prompt}"\`);
-    console.log(\`  POST /approve/\${id}  to approve\`);
-    console.log(\`  POST /reject/\${id}   to reject\`);
-
-    return new Promise<ApprovalResult>((resolve) => {
-      _pendingApprovals.set(id, { resolve, request, createdAt: Date.now() });
-
-      if (request.timeout) {
-        const ms = parseTimeout(request.timeout);
-        if (ms > 0) {
-          setTimeout(() => {
-            if (_pendingApprovals.has(id)) {
-              _pendingApprovals.delete(id);
-              resolve({ approved: false, response: 'Timed out' });
-            }
-          }, ms);
-        }
-      }
-    });
-  },
-};
-
-const approvalProvider: ApprovalProvider = (globalThis as unknown as { __fw_approval_provider__?: ApprovalProvider }).__fw_approval_provider__ ?? _defaultApprovalProvider;`;
-}
-/**
- * Get approval provider code for a given strategy.
- * Mirrors getProviderCode() from providers/index.ts.
- */
-export function getApprovalCode(strategy) {
-    switch (strategy) {
-        case 'callback':
-            return generateCallbackApproval();
-        case 'webhook':
-            return generateWebhookApproval();
-        case 'mock':
-        default:
-            return generateMockApproval();
-    }
-}
-//# sourceMappingURL=index.js.map