openplanr 1.9.0 → 1.10.0

package/README.md

@@ -12,7 +12,7 @@
 [![protocol](https://img.shields.io/badge/protocol-v1.0.0-7c3aed?style=flat-square)](https://github.com/openplanr/planr-pipeline/tree/main/docs/protocol)
 [![runtimes](https://img.shields.io/badge/runtimes-Claude%20Code%20%7C%20Cursor%20%7C%20Codex-f97316?style=flat-square)](https://github.com/openplanr/planr-pipeline/blob/main/docs/compatibility-matrix.md)
 
-**[Website](https://openplanr.dev)** · **[Setup guide](docs/CROSS_RUNTIME_SETUP.md)** · **[Compatibility matrix](https://github.com/openplanr/planr-pipeline/blob/main/docs/compatibility-matrix.md)** · **[Protocol spec](https://github.com/openplanr/planr-pipeline/tree/main/docs/protocol)** · **[CLI reference](docs/CLI.md)**
+**[Website](https://openplanr.dev)** · **[Setup guide](docs/CROSS_RUNTIME_SETUP.md)** · **[Artifact review](docs/ARTIFACT_REVIEW.md)** · **[Compatibility matrix](https://github.com/openplanr/planr-pipeline/blob/main/docs/compatibility-matrix.md)** · **[Protocol spec](https://github.com/openplanr/planr-pipeline/tree/main/docs/protocol)** · **[CLI reference](docs/CLI.md)**
 
 </div>
 
@@ -84,10 +84,13 @@ Same artifacts (`.planr/specs/SPEC-NNN-{slug}/`). Same `.pipeline-shipped` proof
 
 ```bash
 curl -fsSL https://openplanr.dev/install.sh | sh
-planr setup --runtime auto --scope both
+cd my-project
+planr setup
 planr doctor
 ```
 
+The installer installs the CLI only. Guided setup detects coding agents and
+prompts for workflow mode, runtimes, and scope; user scope is the safe default.
 Use `planr setup --dry-run` to preview, `planr setup --minimal` for planning
 only, and `planr runtime rollback` to restore exact pre-migration bytes.
 
@@ -136,6 +139,21 @@ planr pipeline plan auth
 planr pipeline ship auth
 ```
 
+### Review and privately share any HTML artifact
+
+```bash
+planr artifact ./artifact.html
+# Add pins, threads, and an Approve or Request changes decision.
+
+planr artifact share ./artifact.html --no-open
+planr artifact import "<returned-review-url>"
+```
+
+Small reviews remain in the URL fragment and are never sent to the share host.
+Large reviews use an explicitly confirmed, encrypted, expiring short link; the
+decryption key remains in the fragment and the service stores ciphertext only.
+See the [artifact review and privacy guide](docs/ARTIFACT_REVIEW.md).
+
 ---
 
 ## Commands
@@ -336,7 +354,7 @@ OpenPlanr is one of four components:
 | Component | Role | Repo |
 |---|---|---|
 | **`planr` CLI** | Authoring surface — generates `.planr/` artifacts and runtime rule files | this repo |
-| **`planr-pipeline`** | Claude Code plugin — canonical executor (8 subagents, manifest-enforced tool restrictions) | [openplanr/planr-pipeline](https://github.com/openplanr/planr-pipeline) |
+| **`planr-pipeline`** | Portable PO → Design → Review → DEV → QA engine with nine canonical roles and runtime adapters | [openplanr/planr-pipeline](https://github.com/openplanr/planr-pipeline) |
 | **`openplanr` skill** | Routing playbook — teaches Claude when to use which surface | [openplanr/skills](https://github.com/openplanr/skills) |
 | **`openplanr/marketplace`** | Distribution — Claude Code plugin registry | [openplanr/marketplace](https://github.com/openplanr/marketplace) |
 

package/dist/cli/commands/artifact.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from 'commander';
+export declare function registerArtifactCommand(program: Command): void;
+//# sourceMappingURL=artifact.d.ts.map

package/dist/cli/commands/artifact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/artifact.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAwSzC,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAsD9D"}

package/dist/cli/commands/artifact.js

@@ -0,0 +1,249 @@
+import { mkdirSync, writeFileSync } from 'node:fs';
+import path from 'node:path';
+import { ArtifactCommandError, loadArtifactPipeline, openExternalUrl, prepareArtifactEnvelope, withoutArtifactReview, } from '../../services/artifact-pipeline-service.js';
+import { isNonInteractive } from '../../services/interactive-state.js';
+import { promptConfirm } from '../../services/prompt-service.js';
+import { display, logger } from '../../utils/logger.js';
+function projectDir(program) {
+    return path.resolve(program.opts().projectDir);
+}
+function resolveInput(program, value) {
+    return path.resolve(projectDir(program), value);
+}
+function resolveRoot(program, value) {
+    return path.resolve(projectDir(program), value ?? '.');
+}
+function theme(value) {
+    if (value === undefined)
+        return 'auto';
+    if (['auto', 'light', 'dark'].includes(value))
+        return value;
+    throw new ArtifactCommandError('E_ARTIFACT_INPUT_INVALID', 'Artifact theme must be auto, light, or dark.');
+}
+function port(value) {
+    if (value === undefined)
+        return 0;
+    const parsed = Number(value);
+    if (!Number.isInteger(parsed) || parsed < 0 || parsed > 65_535) {
+        throw new ArtifactCommandError('E_ARTIFACT_INPUT_INVALID', 'Artifact review port must be an integer from 0 through 65535.');
+    }
+    return parsed;
+}
+function confirmed(program, local) {
+    return Boolean(local || program.opts().yes);
+}
+async function openArtifact(program, file, options) {
+    const cwd = projectDir(program);
+    const prepared = await prepareArtifactEnvelope({
+        file: resolveInput(program, file),
+        root: resolveRoot(program, options.root),
+        title: options.title,
+    });
+    const session = await prepared.api.startArtifactReview({
+        envelope: prepared.envelope,
+        title: options.title,
+        theme: theme(options.theme),
+        port: port(options.port),
+        noOpen: options.open === false,
+        cwd,
+        openUrl: openExternalUrl,
+    });
+    if (options.json)
+        display.line(JSON.stringify(session));
+    else {
+        logger.success('Artifact review ready');
+        display.keyValue('Session', String(session.sessionId));
+        display.keyValue('URL', String(session.url));
+        display.keyValue('Files', String(prepared.bundle.fileCount));
+        display.keyValue('Bundled', `${prepared.bundle.bytes.toLocaleString()} bytes`);
+        display.blank();
+        logger.dim('Press Ctrl+C to stop the local review session.');
+    }
+    const close = typeof session.close === 'function' ? session.close.bind(session) : undefined;
+    if (close) {
+        const shutdown = async () => {
+            await close().catch(() => undefined);
+            process.exit(0);
+        };
+        process.once('SIGINT', shutdown);
+        process.once('SIGTERM', shutdown);
+    }
+}
+async function shareArtifact(program, file, options) {
+    const prepared = await prepareArtifactEnvelope({
+        file: resolveInput(program, file),
+        root: resolveRoot(program, options.root),
+        title: options.title,
+    });
+    const preview = prepared.api.createReviewLinkPreview(prepared.envelope);
+    const yes = confirmed(program, options.yes);
+    if (!preview.fragmentEligible && isNonInteractive() && !(options.short && yes)) {
+        throw new ArtifactCommandError('E_ARTIFACT_SHORT_CONFIRMATION_REQUIRED', 'This artifact is too large for a private fragment link.', 'Rerun with `planr artifact share <file> --short --yes` to upload encrypted ciphertext.');
+    }
+    const needsConsent = Boolean(options.short || !preview.fragmentEligible);
+    let allowShort = yes;
+    if (needsConsent && !allowShort) {
+        if (isNonInteractive()) {
+            throw new ArtifactCommandError('E_ARTIFACT_SHORT_CONFIRMATION_REQUIRED', 'Encrypted short-link creation requires explicit confirmation.', 'Rerun with `--short --yes`.');
+        }
+        display.keyValue('Encrypted size', `${preview.ciphertextBytes.toLocaleString()} bytes`);
+        display.keyValue('Expiry', options.ttl ?? '7d');
+        allowShort = await promptConfirm('Upload ciphertext to share.openplanr.dev? The decryption key remains in the URL fragment.', true);
+    }
+    const result = await prepared.api.createReviewLink(prepared.envelope, {
+        baseUrl: process.env.OPENPLANR_SHARE_BASE ?? 'https://share.openplanr.dev',
+        short: Boolean(options.short),
+        transport: options.short ? 'short' : 'auto',
+        ttl: options.ttl ?? '7d',
+        confirmed: allowShort,
+        yes: allowShort,
+    });
+    const url = String(result.url);
+    if (options.open !== false)
+        await openExternalUrl(url);
+    if (options.json)
+        display.line(JSON.stringify(result));
+    else {
+        logger.success(result.uploaded ? 'Encrypted short link created' : 'Private fragment link created');
+        display.keyValue('URL', url);
+        display.keyValue('Transport', String(result.transport));
+        if (result.expiresAt)
+            display.keyValue('Expires', String(result.expiresAt));
+        if (result.deletionToken) {
+            display.keyValue('Deletion token', String(result.deletionToken));
+            logger.warn('Save the deletion token now; it is shown only once and is not part of the review URL.');
+        }
+    }
+}
+function assertReviewEnvelope(value, artifactId) {
+    if (!value.review) {
+        throw new ArtifactCommandError('E_ARTIFACT_REVIEW_IMPORT', 'The supplied link contains an artifact but no returned review.');
+    }
+    if (artifactId && value.viewer.activeArtifactId !== artifactId) {
+        throw new ArtifactCommandError('E_ARTIFACT_REVIEW_IMPORT', 'All imported review links must target the same artifact.');
+    }
+}
+async function importArtifactReviews(program, sources, options) {
+    const api = await loadArtifactPipeline();
+    const decoded = await Promise.all(sources.map((source) => api.decodeReviewLink(source)));
+    const artifactId = decoded[0]?.viewer.activeArtifactId;
+    for (const envelope of decoded)
+        assertReviewEnvelope(envelope, artifactId);
+    const currentEnvelope = withoutArtifactReview(decoded[0]);
+    const input = {
+        sources: decoded,
+        currentEnvelope,
+        cwd: projectDir(program),
+    };
+    let result;
+    try {
+        result = await api.importArtifactReview({ ...input, allowStale: false, persist: true });
+    }
+    catch (error) {
+        const value = error;
+        if (value.code !== 'E_ARTIFACT_STALE_REVIEW' || !options.allowStale)
+            throw error;
+        const yes = confirmed(program, options.yes);
+        if (!yes && isNonInteractive()) {
+            throw new ArtifactCommandError('E_ARTIFACT_CONFIRMATION_REQUIRED', 'Importing stale artifact feedback requires explicit confirmation.', 'Review the preview and rerun with `--allow-stale --yes`.');
+        }
+        if (!options.json) {
+            logger.warn('The returned review targets an older artifact digest and will remain marked stale.');
+            if (value.details?.localDigest)
+                display.keyValue('Current digest', value.details.localDigest);
+            if (value.details?.reviewDigest)
+                display.keyValue('Review digest', value.details.reviewDigest);
+            display.keyValue('Pins', String(value.details?.pinCount ?? 0));
+            display.keyValue('Replies', String(value.details?.replyCount ?? 0));
+        }
+        if (!yes &&
+            !(await promptConfirm('Import this stale review without changing its digest?', false))) {
+            if (options.json)
+                display.line(JSON.stringify({ ok: false, action: 'cancelled' }));
+            return;
+        }
+        result = await api.importArtifactReview({ ...input, allowStale: true, persist: true });
+    }
+    if (options.output) {
+        const output = path.resolve(projectDir(program), options.output);
+        mkdirSync(path.dirname(output), { recursive: true });
+        writeFileSync(output, `${JSON.stringify(result.reviewState, null, 2)}\n`, { mode: 0o600 });
+    }
+    if (options.json)
+        display.line(JSON.stringify(result));
+    else {
+        logger.success(`Imported ${String(result.imported?.length ?? 0)} review(s)`);
+        display.keyValue('Artifact', String(result.artifactId));
+        display.keyValue('Decision', String(result.effectiveDecision));
+        display.keyValue('Destination', String(result.destination?.kind ?? 'local'));
+        if (options.output)
+            display.keyValue('Output', path.resolve(projectDir(program), options.output));
+    }
+}
+async function exportArtifactReview(program, sessionId, options) {
+    const format = options.format ?? 'json';
+    if (!['json', 'markdown'].includes(format)) {
+        throw new ArtifactCommandError('E_ARTIFACT_REVIEW_EXPORT', 'Artifact review export format must be json or markdown.');
+    }
+    const api = await loadArtifactPipeline();
+    const result = await api.exportArtifactReviewSession(sessionId, {
+        format: format,
+    });
+    if (!options.output) {
+        process.stdout.write(result.content);
+        return;
+    }
+    const output = path.resolve(projectDir(program), options.output);
+    mkdirSync(path.dirname(output), { recursive: true });
+    writeFileSync(output, result.content, { mode: 0o600 });
+    logger.success(`Artifact review exported to ${output}`);
+}
+function addOpenOptions(command) {
+    return command
+        .option('--title <title>', 'review title')
+        .option('--root <asset-root>', 'root for local artifact dependencies')
+        .option('--theme <theme>', 'auto, light, or dark', 'auto')
+        .option('--port <port>', 'loopback review port')
+        .option('--no-open', 'do not open a browser')
+        .option('--json', 'emit machine-readable output', false);
+}
+export function registerArtifactCommand(program) {
+    const artifact = addOpenOptions(program
+        .command('artifact [file]')
+        .description('Review, share, import, and export HTML artifacts'));
+    artifact.enablePositionalOptions();
+    artifact.action(async (file, _options, command) => {
+        if (!file) {
+            artifact.help();
+            return;
+        }
+        await openArtifact(program, file, command.optsWithGlobals());
+    });
+    addOpenOptions(artifact.command('open <file>').description('Open a local HTML review session')).action((file, _options, command) => openArtifact(program, file, command.optsWithGlobals()));
+    artifact
+        .command('share <file>')
+        .description('Create an immutable private review link')
+        .option('--title <title>', 'review title')
+        .option('--root <asset-root>', 'root for local artifact dependencies')
+        .option('--short', 'create an encrypted expiring short link', false)
+        .option('--ttl <ttl>', '1d, 7d, or 30d', '7d')
+        .option('--no-open', 'do not open the review link')
+        .option('--json', 'emit machine-readable output', false)
+        .option('--yes', 'confirm encrypted upload non-interactively', false)
+        .action((file, _options, command) => shareArtifact(program, file, command.optsWithGlobals()));
+    artifact
+        .command('import <review-url...>')
+        .description('Import one or more immutable returned-review links')
+        .option('--output <path>', 'also write the merged review state to this path')
+        .option('--allow-stale', 'preview and explicitly accept stale feedback', false)
+        .option('--json', 'emit machine-readable output', false)
+        .option('--yes', 'confirm stale import non-interactively', false)
+        .action((sources, _options, command) => importArtifactReviews(program, sources, command.optsWithGlobals()));
+    artifact
+        .command('export <session-id>')
+        .description('Export feedback from a live local review session')
+        .option('--format <format>', 'json or markdown', 'json')
+        .option('--output <path>', 'write the export to a file')
+        .action((sessionId, _options, command) => exportArtifactReview(program, sessionId, command.optsWithGlobals()));
+}
+//# sourceMappingURL=artifact.js.map

package/dist/cli/commands/artifact.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact.js","sourceRoot":"","sources":["../../../src/cli/commands/artifact.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/doctor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/doctor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKzC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,QA+CzE"}
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/doctor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAazC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,QA4EzE"}

package/dist/cli/commands/doctor.js

@@ -1,5 +1,6 @@
+import { isNonInteractive } from '../../services/interactive-state.js';
 import { promptConfirm } from '../../services/prompt-service.js';
-import { applySetup, runtimeDoctor } from '../../services/runtime-manager-service.js';
+import { applySetup, cleanupHomeProjectInstall, isOpenPlanrHome, managedRuntimesForProject, previewHomeProjectCleanup, runtimeDoctor, } from '../../services/runtime-manager-service.js';
 import { display, logger } from '../../utils/logger.js';
 export function registerDoctorCommand(program, cliVersion) {
     program
@@ -13,24 +14,53 @@ export function registerDoctorCommand(program, cliVersion) {
         const projectDir = program.opts().projectDir;
         let result = await runtimeDoctor(projectDir);
         if (opts.fix) {
-            const preview = await applySetup({
-                projectDir,
-                cliVersion,
-                runtime: 'auto',
-                scope: 'both',
-                dryRun: true,
-            });
+            const homeCleanup = await previewHomeProjectCleanup();
+            const managedRuntimes = isOpenPlanrHome(projectDir)
+                ? []
+                : await managedRuntimesForProject(projectDir);
+            const preview = managedRuntimes.length
+                ? await applySetup({
+                    projectDir,
+                    cliVersion,
+                    runtimes: managedRuntimes,
+                    scope: 'user',
+                    preserveExistingScopes: true,
+                    dryRun: true,
+                })
+                : null;
             if (!opts.json) {
                 logger.heading('Repair preview');
-                for (const action of preview.actions.filter((item) => item.operation !== 'unchanged')) {
+                for (const target of homeCleanup)
+                    display.bullet(`remove ${target}`);
+                for (const action of (preview?.actions ?? []).filter((item) => item.operation !== 'unchanged')) {
                     display.bullet(`${action.operation} ${action.target}`);
                 }
             }
-            const confirmed = opts.yes ||
-                program.opts().yes ||
-                (await promptConfirm('Apply owned-file repairs?', true));
+            const hasRepairs = homeCleanup.length > 0 ||
+                (preview?.actions ?? []).some((item) => item.operation !== 'unchanged');
+            if (!hasRepairs) {
+                if (!opts.json)
+                    logger.success('No owned-file repairs are needed.');
+            }
+            const confirmed = hasRepairs &&
+                (opts.yes ||
+                    program.opts().yes ||
+                    (!isNonInteractive() && (await promptConfirm('Apply owned-file repairs?', true))));
+            if (hasRepairs && !confirmed && isNonInteractive() && !opts.json) {
+                logger.warn('Repairs were not applied; rerun with --yes after reviewing the preview.');
+            }
             if (confirmed) {
-                await applySetup({ projectDir, cliVersion, runtime: 'auto', scope: 'both' });
+                if (homeCleanup.length)
+                    await cleanupHomeProjectInstall();
+                if (managedRuntimes.length) {
+                    await applySetup({
+                        projectDir,
+                        cliVersion,
+                        runtimes: managedRuntimes,
+                        scope: 'user',
+                        preserveExistingScopes: true,
+                    });
+                }
                 result = await runtimeDoctor(projectDir);
             }
         }

package/dist/cli/commands/doctor.js.map

@@ -1 +1 @@
-{"version":3,"file":"doctor.js","sourceRoot":"","sources":["../../../src/cli/commands/doctor.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"doctor.js","sourceRoot":"","sources":["../../../src/cli/commands/doctor.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/pipeline.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/pipeline.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAezC,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,QA2BvD"}
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/pipeline.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAoBzC,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,QA4BvD"}

package/dist/cli/commands/pipeline.js

@@ -10,34 +10,38 @@ const ACTIONS = [
     'dashboard',
     'sync',
     'doctor',
+    'prepare-plan',
+    'complete-plan',
+    'prepare-ship',
+    'finalize-ship',
+    'design-engine',
 ];
 export function registerPipelineCommand(program) {
     program
-        .command('pipeline <action> [feature]')
+        .command('pipeline <action> [args...]')
         .description('Route the complete PO, Design, DEV, and QA pipeline')
         .option('--runtime <runtime>', 'auto, claude, codex, or cursor')
         .option('--json', 'machine-readable output', false)
         .option('--no-launch', 'return a runtime handoff instead of launching')
         .option('--port <port>', 'dashboard port')
         .option('--no-watch', 'disable dashboard file watching')
-        .action((action, feature, opts) => {
+        .allowUnknownOption(true)
+        .action((action, passthrough, opts) => {
         if (!ACTIONS.includes(action))
             throw new Error(`Unknown pipeline action: ${action}`);
         const pipeline = resolvePipelinePackage();
         if (!pipeline)
             throw new Error('E_PIPELINE_NOT_INSTALLED');
-        const args = [pipeline.binPath, action];
-        if (feature)
-            args.push(feature);
-        if (opts.runtime && opts.runtime !== 'auto')
+        const args = [pipeline.binPath, action, ...passthrough];
+        if (opts.runtime && opts.runtime !== 'auto' && !passthrough.includes('--runtime'))
             args.push('--runtime', opts.runtime);
-        if (opts.json)
+        if (opts.json && !passthrough.includes('--json'))
             args.push('--json');
-        if (opts.launch === false)
+        if (opts.launch === false && !passthrough.includes('--no-launch'))
             args.push('--no-launch');
-        if (opts.port)
+        if (opts.port && !passthrough.includes('--port'))
             args.push('--port', String(opts.port));
-        if (opts.watch === false)
+        if (opts.watch === false && !passthrough.includes('--no-watch'))
             args.push('--no-watch');
         const result = spawnSync(process.execPath, args, {
             cwd: program.opts().projectDir,

package/dist/cli/commands/pipeline.js.map

@@ -1 +1 @@
-{"version":3,"file":"pipeline.js","sourceRoot":"","sources":["../../../src/cli/commands/pipeline.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE/C,OAAO,EAAE,sBAAsB,EAAE,MAAM,4CAA4C,CAAC;AAEpF,MAAM,OAAO,GAAG;IACd,MAAM;IACN,QAAQ;IACR,aAAa;IACb,eAAe;IACf,MAAM;IACN,QAAQ;IACR,WAAW;IACX,MAAM;IACN,QAAQ;CACT,CAAC;AAEF,MAAM,UAAU,uBAAuB,CAAC,OAAgB;IACtD,OAAO;SACJ,OAAO,CAAC,6BAA6B,CAAC;SACtC,WAAW,CAAC,qDAAqD,CAAC;SAClE,MAAM,CAAC,qBAAqB,EAAE,gCAAgC,CAAC;SAC/D,MAAM,CAAC,QAAQ,EAAE,yBAAyB,EAAE,KAAK,CAAC;SAClD,MAAM,CAAC,aAAa,EAAE,+CAA+C,CAAC;SACtE,MAAM,CAAC,eAAe,EAAE,gBAAgB,CAAC;SACzC,MAAM,CAAC,YAAY,EAAE,iCAAiC,CAAC;SACvD,MAAM,CAAC,CAAC,MAAc,EAAE,OAA2B,EAAE,IAAI,EAAE,EAAE;QAC5D,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,MAAM,EAAE,CAAC,CAAC;QACrF,MAAM,QAAQ,GAAG,sBAAsB,EAAE,CAAC;QAC1C,IAAI,CAAC,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;QAC3D,MAAM,IAAI,GAAG,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACxC,IAAI,OAAO;YAAE,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAChC,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO,KAAK,MAAM;YAAE,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QAClF,IAAI,IAAI,CAAC,IAAI;YAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACnC,IAAI,IAAI,CAAC,MAAM,KAAK,KAAK;YAAE,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACpD,IAAI,IAAI,CAAC,IAAI;YAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QACtD,IAAI,IAAI,CAAC,KAAK,KAAK,KAAK;YAAE,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAClD,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,EAAE;YAC/C,GAAG,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,UAAoB;YACxC,KAAK,EAAE,SAAS;SACjB,CAAC,CAAC;QACH,IAAI,MAAM,CAAC,KAAK;YAAE,MAAM,MAAM,CAAC,KAAK,CAAC;QACrC,OAAO,CAAC,QAAQ,GAAG,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;AACP,CAAC"}
+{"version":3,"file":"pipeline.js","sourceRoot":"","sources":["../../../src/cli/commands/pipeline.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE/C,OAAO,EAAE,sBAAsB,EAAE,MAAM,4CAA4C,CAAC;AAEpF,MAAM,OAAO,GAAG;IACd,MAAM;IACN,QAAQ;IACR,aAAa;IACb,eAAe;IACf,MAAM;IACN,QAAQ;IACR,WAAW;IACX,MAAM;IACN,QAAQ;IACR,cAAc;IACd,eAAe;IACf,cAAc;IACd,eAAe;IACf,eAAe;CAChB,CAAC;AAEF,MAAM,UAAU,uBAAuB,CAAC,OAAgB;IACtD,OAAO;SACJ,OAAO,CAAC,6BAA6B,CAAC;SACtC,WAAW,CAAC,qDAAqD,CAAC;SAClE,MAAM,CAAC,qBAAqB,EAAE,gCAAgC,CAAC;SAC/D,MAAM,CAAC,QAAQ,EAAE,yBAAyB,EAAE,KAAK,CAAC;SAClD,MAAM,CAAC,aAAa,EAAE,+CAA+C,CAAC;SACtE,MAAM,CAAC,eAAe,EAAE,gBAAgB,CAAC;SACzC,MAAM,CAAC,YAAY,EAAE,iCAAiC,CAAC;SACvD,kBAAkB,CAAC,IAAI,CAAC;SACxB,MAAM,CAAC,CAAC,MAAc,EAAE,WAAqB,EAAE,IAAI,EAAE,EAAE;QACtD,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,MAAM,EAAE,CAAC,CAAC;QACrF,MAAM,QAAQ,GAAG,sBAAsB,EAAE,CAAC;QAC1C,IAAI,CAAC,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;QAC3D,MAAM,IAAI,GAAG,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,WAAW,CAAC,CAAC;QACxD,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO,KAAK,MAAM,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,WAAW,CAAC;YAC/E,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QACvC,IAAI,IAAI,CAAC,IAAI,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,QAAQ,CAAC;YAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACtE,IAAI,IAAI,CAAC,MAAM,KAAK,KAAK,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,aAAa,CAAC;YAAE,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAC5F,IAAI,IAAI,CAAC,IAAI,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,QAAQ,CAAC;YAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QACzF,IAAI,IAAI,CAAC,KAAK,KAAK,KAAK,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,YAAY,CAAC;YAAE,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACzF,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,EAAE;YAC/C,GAAG,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,UAAoB;YACxC,KAAK,EAAE,SAAS;SACjB,CAAC,CAAC;QACH,IAAI,MAAM,CAAC,KAAK;YAAE,MAAM,MAAM,CAAC,KAAK,CAAC;QACrC,OAAO,CAAC,QAAQ,GAAG,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/cli/commands/setup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/setup.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAUzC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,QAkDxE"}
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/setup.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA2DzC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,QAyJxE"}