mcoda 0.1.38 → 0.1.41

package/dist/commands/consent/ConsentCommands.js

@@ -0,0 +1,170 @@
+import packageJson from '../../../package.json' with { type: 'json' };
+import { MswarmConfigStore, } from '@mcoda/core';
+import { acceptMswarmConsent, buildMswarmApi, } from './MswarmConsentFlow.js';
+const USAGE = `
+Usage: mcoda consent <show|accept|revoke|request-deletion> [options]
+
+Subcommands:
+  show                     Display the persisted mswarm consent state
+  accept                   Register/refresh consent with mswarm and persist the local client identity
+  revoke                   Revoke the currently stored mswarm consent token
+  request-deletion         Submit a data deletion request to mswarm for this client identity
+
+Options:
+  --policy-version <VER>   Override the consent policy version for \`accept\`
+  --reason <TEXT>          Attach a reason to \`revoke\` or \`request-deletion\`
+  --json                   Emit JSON output
+  --help                   Show this help
+`.trim();
+export class ConsentCommands {
+    static async run(argv) {
+        const parsed = parseConsentArgs(argv);
+        if (!parsed.subcommand || argv.includes('--help') || argv.includes('-h')) {
+            // eslint-disable-next-line no-console
+            console.log(USAGE);
+            return;
+        }
+        const store = new MswarmConfigStore();
+        const state = await store.readState();
+        if (parsed.subcommand === 'show') {
+            render(parsed.json, {
+                consentAccepted: Boolean(state.consentAccepted),
+                consentTokenSet: Boolean(state.consentToken?.trim()),
+                clientId: state.clientId,
+                clientType: state.clientType,
+                policyVersion: state.consentPolicyVersion,
+                apiKeySet: Boolean(state.apiKey?.trim()),
+                baseUrl: state.baseUrl,
+                uploadSigningSecretSet: Boolean(state.uploadSigningSecret?.trim()),
+                deletionRequestedAtMs: state.deletionRequestedAtMs,
+            });
+            return;
+        }
+        if (parsed.subcommand === 'accept') {
+            const nextState = await acceptMswarmConsent({
+                state,
+                policyVersion: parsed.policyVersion,
+                productVersion: String(packageJson.version ?? 'dev'),
+            });
+            render(parsed.json, {
+                consentAccepted: Boolean(nextState.consentAccepted),
+                consentTokenSet: Boolean(nextState.consentToken?.trim()),
+                clientId: nextState.clientId,
+                clientType: nextState.clientType,
+                policyVersion: nextState.consentPolicyVersion,
+                apiKeySet: Boolean(nextState.apiKey?.trim()),
+                baseUrl: nextState.baseUrl,
+                uploadSigningSecretSet: Boolean(nextState.uploadSigningSecret?.trim()),
+                deletionRequestedAtMs: nextState.deletionRequestedAtMs,
+            });
+            return;
+        }
+        if (parsed.subcommand === 'revoke') {
+            const consentToken = state.consentToken?.trim();
+            if (!consentToken) {
+                throw new Error('No persisted mswarm consent token is available. Run `mcoda consent accept` first.');
+            }
+            const api = await buildMswarmApi(state);
+            try {
+                const response = await api.revokeConsent(consentToken, parsed.reason);
+                await store.clearConsentState();
+                render(parsed.json, {
+                    revoked: response.revoked,
+                    revokedAtMs: response.revoked_at_ms ?? null,
+                });
+            }
+            finally {
+                await api.close();
+            }
+            return;
+        }
+        if (parsed.subcommand === 'request-deletion') {
+            const consentToken = state.consentToken?.trim();
+            if (!consentToken) {
+                throw new Error('No persisted mswarm consent token is available. Run `mcoda consent accept` first.');
+            }
+            const api = await buildMswarmApi(state);
+            try {
+                const response = await api.requestDataDeletion({
+                    consentToken,
+                    product: 'mcoda',
+                    clientId: state.apiKey?.trim() ? undefined : state.clientId,
+                    clientType: state.apiKey?.trim() ? undefined : state.clientType,
+                    reason: parsed.reason,
+                });
+                const deletionRequestedAtMs = Date.now();
+                await store.saveConsentState({
+                    consentAccepted: Boolean(state.consentAccepted),
+                    consentPolicyVersion: state.consentPolicyVersion,
+                    consentToken: state.consentToken,
+                    clientId: state.clientId,
+                    clientType: state.clientType,
+                    registeredAtMs: state.registeredAtMs,
+                    uploadSigningSecret: state.uploadSigningSecret,
+                    deletionRequestedAtMs,
+                });
+                render(parsed.json, {
+                    accepted: response.accepted,
+                    requestId: response.request_id,
+                    product: response.product,
+                    clientId: response.client_id,
+                    clientType: response.client_type,
+                    tenantId: response.tenant_id,
+                    status: response.status,
+                    requestedAt: response.requested_at,
+                    deletionRequestedAtMs,
+                });
+            }
+            finally {
+                await api.close();
+            }
+            return;
+        }
+        throw new Error(`Unknown consent subcommand: ${parsed.subcommand}`);
+    }
+}
+export function parseConsentArgs(argv) {
+    const parsed = { json: false };
+    const positionals = [];
+    for (let index = 0; index < argv.length; index += 1) {
+        const value = argv[index];
+        if (value === '--json') {
+            parsed.json = true;
+            continue;
+        }
+        if (value === '--policy-version') {
+            const next = argv[index + 1];
+            if (!next?.trim()) {
+                throw new Error('--policy-version requires a value');
+            }
+            parsed.policyVersion = next.trim();
+            index += 1;
+            continue;
+        }
+        if (value === '--reason') {
+            const next = argv[index + 1];
+            if (!next?.trim()) {
+                throw new Error('--reason requires a value');
+            }
+            parsed.reason = next.trim();
+            index += 1;
+            continue;
+        }
+        if (value.startsWith('--')) {
+            throw new Error(`Unknown consent flag: ${value}`);
+        }
+        positionals.push(value);
+    }
+    parsed.subcommand = positionals[0];
+    return parsed;
+}
+function render(json, payload) {
+    if (json) {
+        // eslint-disable-next-line no-console
+        console.log(JSON.stringify(payload, null, 2));
+        return;
+    }
+    const fragments = Object.entries(payload).map(([key, value]) => `${key}=${String(value)}`);
+    // eslint-disable-next-line no-console
+    console.log(fragments.join(' '));
+}

package/dist/commands/consent/MswarmConsentFlow.d.ts

@@ -0,0 +1,10 @@
+import { MswarmApi, MswarmConfigStore } from '@mcoda/core';
+import { type MswarmConfigState } from '@mcoda/core';
+export declare function acceptMswarmConsent(options?: {
+    state?: MswarmConfigState;
+    policyVersion?: string;
+    productVersion?: string;
+    store?: MswarmConfigStore;
+}): Promise<MswarmConfigState>;
+export declare function buildMswarmApi(state: MswarmConfigState): Promise<MswarmApi>;
+//# sourceMappingURL=MswarmConsentFlow.d.ts.map

package/dist/commands/consent/MswarmConsentFlow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MswarmConsentFlow.d.ts","sourceRoot":"","sources":["../../../src/commands/consent/MswarmConsentFlow.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAC3D,OAAO,EAGL,KAAK,iBAAiB,EACvB,MAAM,aAAa,CAAC;AAErB,wBAAsB,mBAAmB,CAAC,OAAO,GAAE;IACjD,KAAK,CAAC,EAAE,iBAAiB,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,iBAAiB,CAAC;CACtB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAiDlC;AAED,wBAAsB,cAAc,CAClC,KAAK,EAAE,iBAAiB,GACvB,OAAO,CAAC,SAAS,CAAC,CAOpB"}

package/dist/commands/consent/MswarmConsentFlow.js

@@ -0,0 +1,57 @@
+import { MswarmApi, MswarmConfigStore } from '@mcoda/core';
+import { MCODA_FREE_CLIENT_TYPE, MSWARM_CONSENT_POLICY_VERSION, } from '@mcoda/core';
+export async function acceptMswarmConsent(options = {}) {
+    const store = options.store ?? new MswarmConfigStore();
+    const state = options.state ?? (await store.readState());
+    const api = await buildMswarmApi(state);
+    try {
+        const effectivePolicyVersion = options.policyVersion?.trim() ||
+            state.consentPolicyVersion ||
+            MSWARM_CONSENT_POLICY_VERSION;
+        if (state.apiKey?.trim()) {
+            const response = await api.issuePaidConsent(effectivePolicyVersion);
+            const clientId = response.client_id || response.tenant_id || state.clientId;
+            const clientType = response.client_type || 'paid_mcoda_client';
+            return store.saveConsentState({
+                consentAccepted: true,
+                consentPolicyVersion: effectivePolicyVersion,
+                consentToken: response.consent_token,
+                clientId,
+                clientType,
+                registeredAtMs: response.issued_at_ms ?? Date.now(),
+                uploadSigningSecret: response.upload_signing_secret,
+                deletionRequestedAtMs: state.deletionRequestedAtMs,
+            });
+        }
+        const response = await api.registerFreeMcodaClient({
+            clientId: state.clientId,
+            policyVersion: effectivePolicyVersion,
+            productVersion: options.productVersion?.trim() || 'dev',
+        });
+        const clientId = response.client_id || state.clientId;
+        if (!clientId) {
+            throw new Error('mswarm free-client registration did not return a client id');
+        }
+        return store.saveConsentState({
+            consentAccepted: true,
+            consentPolicyVersion: effectivePolicyVersion,
+            consentToken: response.consent_token,
+            clientId,
+            clientType: response.client_type || MCODA_FREE_CLIENT_TYPE,
+            registeredAtMs: response.issued_at_ms ?? Date.now(),
+            uploadSigningSecret: response.upload_signing_secret,
+            deletionRequestedAtMs: state.deletionRequestedAtMs,
+        });
+    }
+    finally {
+        await api.close();
+    }
+}
+export async function buildMswarmApi(state) {
+    return MswarmApi.create({
+        baseUrl: state.baseUrl,
+        apiKey: state.apiKey,
+        timeoutMs: state.timeoutMs,
+        agentSlugPrefix: state.agentSlugPrefix,
+    });
+}

package/dist/commands/setup/SetupCommand.d.ts

@@ -0,0 +1,10 @@
+type ParsedSetupArgs = {
+    json: boolean;
+    policyVersion?: string;
+};
+export declare class SetupCommand {
+    static run(argv: string[]): Promise<void>;
+}
+export declare function parseSetupArgs(argv: string[]): ParsedSetupArgs;
+export {};
+//# sourceMappingURL=SetupCommand.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SetupCommand.d.ts","sourceRoot":"","sources":["../../../src/commands/setup/SetupCommand.ts"],"names":[],"mappings":"AAaA,KAAK,eAAe,GAAG;IACrB,IAAI,EAAE,OAAO,CAAC;IACd,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,qBAAa,YAAY;WACV,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAgChD;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,eAAe,CA0B9D"}

package/dist/commands/setup/SetupCommand.js

@@ -0,0 +1,78 @@
+import { runMswarmConsentBootstrap } from '../../install/MswarmConsentBootstrap.js';
+const USAGE = `
+Usage: mcoda setup [options]
+
+Runs the interactive mcoda setup flow for mandatory mswarm telemetry consent.
+
+Options:
+  --policy-version <VER>   Override the consent policy version
+  --json                   Emit JSON output
+  --help                   Show this help
+`.trim();
+export class SetupCommand {
+    static async run(argv) {
+        const parsed = parseSetupArgs(argv);
+        if (argv.includes('--help') || argv.includes('-h')) {
+            // eslint-disable-next-line no-console
+            console.log(USAGE);
+            return;
+        }
+        const result = await runMswarmConsentBootstrap({
+            mode: 'setup',
+            onDeferred: 'error',
+            policyVersion: parsed.policyVersion,
+            logger: parsed.json ? defaultErrorLogger : defaultLogger,
+        });
+        if (parsed.json) {
+            // eslint-disable-next-line no-console
+            console.log(JSON.stringify(result, null, 2));
+            return;
+        }
+        // eslint-disable-next-line no-console
+        console.log([
+            `status=${result.status}`,
+            `consentAccepted=${String(result.consentAccepted)}`,
+            `consentTokenSet=${String(result.consentTokenSet)}`,
+            result.clientId ? `clientId=${result.clientId}` : undefined,
+            result.clientType ? `clientType=${result.clientType}` : undefined,
+            result.policyVersion ? `policyVersion=${result.policyVersion}` : undefined,
+        ]
+            .filter(Boolean)
+            .join(' '));
+    }
+}
+export function parseSetupArgs(argv) {
+    const parsed = { json: false };
+    for (let index = 0; index < argv.length; index += 1) {
+        const value = argv[index];
+        if (value === '--json') {
+            parsed.json = true;
+            continue;
+        }
+        if (value === '--policy-version') {
+            const next = argv[index + 1];
+            if (!next?.trim()) {
+                throw new Error('--policy-version requires a value');
+            }
+            parsed.policyVersion = next.trim();
+            index += 1;
+            continue;
+        }
+        if (value === '--help' || value === '-h') {
+            continue;
+        }
+        if (value.startsWith('--')) {
+            throw new Error(`Unknown setup flag: ${value}`);
+        }
+        throw new Error(`Unknown setup argument: ${value}`);
+    }
+    return parsed;
+}
+function defaultLogger(line) {
+    // eslint-disable-next-line no-console
+    console.log(line);
+}
+function defaultErrorLogger(line) {
+    // eslint-disable-next-line no-console
+    console.error(line);
+}

package/dist/index.d.ts

@@ -1,25 +1,27 @@
-export * from "./commands/agents/AgentsCommands.js";
-export * from "./bin/McodaEntrypoint.js";
-export * from "./commands/cloud/CloudCommands.js";
-export * from "./commands/config/ConfigCommands.js";
-export * from "./commands/docs/DocsCommands.js";
-export * from "./commands/jobs/JobsCommands.js";
-export * from "./commands/openapi/OpenapiCommands.js";
-export * from "./commands/planning/CreateTasksCommand.js";
-export * from "./commands/backlog/BacklogCommands.js";
-export * from "./commands/backlog/TaskShowCommands.js";
-export * from "./commands/backlog/OrderTasksCommand.js";
-export * from "./commands/estimate/EstimateCommands.js";
-export * from "./commands/telemetry/TelemetryCommands.js";
-export * from "./commands/planning/RefineTasksCommand.js";
-export * from "./commands/planning/TaskSufficiencyAuditCommand.js";
-export * from "./commands/planning/SdsPreflightCommand.js";
-export * from "./commands/work/WorkOnTasksCommand.js";
-export * from "./commands/work/GatewayTrioCommand.js";
-export * from "./commands/review/CodeReviewCommand.js";
-export * from "./commands/planning/QaTasksCommand.js";
-export * from "./commands/update/UpdateCommands.js";
-export * from "./commands/routing/RoutingCommands.js";
-export * from "./commands/agents/TestAgentCommand.js";
-export * from "./commands/workspace/ProjectGuidanceCommand.js";
+export * from './commands/agents/AgentsCommands.js';
+export * from './bin/McodaEntrypoint.js';
+export * from './commands/cloud/CloudCommands.js';
+export * from './commands/config/ConfigCommands.js';
+export * from './commands/consent/ConsentCommands.js';
+export * from './commands/docs/DocsCommands.js';
+export * from './commands/jobs/JobsCommands.js';
+export * from './commands/openapi/OpenapiCommands.js';
+export * from './commands/planning/CreateTasksCommand.js';
+export * from './commands/backlog/BacklogCommands.js';
+export * from './commands/backlog/TaskShowCommands.js';
+export * from './commands/backlog/OrderTasksCommand.js';
+export * from './commands/estimate/EstimateCommands.js';
+export * from './commands/telemetry/TelemetryCommands.js';
+export * from './commands/planning/RefineTasksCommand.js';
+export * from './commands/planning/TaskSufficiencyAuditCommand.js';
+export * from './commands/planning/SdsPreflightCommand.js';
+export * from './commands/work/WorkOnTasksCommand.js';
+export * from './commands/work/GatewayTrioCommand.js';
+export * from './commands/review/CodeReviewCommand.js';
+export * from './commands/planning/QaTasksCommand.js';
+export * from './commands/update/UpdateCommands.js';
+export * from './commands/routing/RoutingCommands.js';
+export * from './commands/setup/SetupCommand.js';
+export * from './commands/agents/TestAgentCommand.js';
+export * from './commands/workspace/ProjectGuidanceCommand.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,qCAAqC,CAAC;AACpD,cAAc,0BAA0B,CAAC;AACzC,cAAc,mCAAmC,CAAC;AAClD,cAAc,qCAAqC,CAAC;AACpD,cAAc,iCAAiC,CAAC;AAChD,cAAc,iCAAiC,CAAC;AAChD,cAAc,uCAAuC,CAAC;AACtD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,uCAAuC,CAAC;AACtD,cAAc,wCAAwC,CAAC;AACvD,cAAc,yCAAyC,CAAC;AACxD,cAAc,yCAAyC,CAAC;AACxD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,2CAA2C,CAAC;AAC1D,cAAc,oDAAoD,CAAC;AACnE,cAAc,4CAA4C,CAAC;AAC3D,cAAc,uCAAuC,CAAC;AACtD,cAAc,uCAAuC,CAAC;AACtD,cAAc,wCAAwC,CAAC;AACvD,cAAc,uCAAuC,CAAC;AACtD,cAAc,qCAAqC,CAAC;AACpD,cAAc,uCAAuC,CAAC;AACtD,cAAc,uCAAuC,CAAC;AACtD,cAAc,gDAAgD,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,qCAAqC,CAAC;AACpD,cAAc,0BAA0B,CAAC;AACzC,cAAc,mCAAmC,CAAC;AAClD,cAAc,qCAAqC,CAAC;AACpD,cAAc,uCAAuC,CAAC;AACtD,cAAc,iCAAiC,CAAC;AAChD,cAAc,iCAAiC,CAAC;AAChD,cAAc,uCAAuC,CAAC;AACtD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,uCAAuC,CAAC;AACtD,cAAc,wCAAwC,CAAC;AACvD,cAAc,yCAAyC,CAAC;AACxD,cAAc,yCAAyC,CAAC;AACxD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,2CAA2C,CAAC;AAC1D,cAAc,oDAAoD,CAAC;AACnE,cAAc,4CAA4C,CAAC;AAC3D,cAAc,uCAAuC,CAAC;AACtD,cAAc,uCAAuC,CAAC;AACtD,cAAc,wCAAwC,CAAC;AACvD,cAAc,uCAAuC,CAAC;AACtD,cAAc,qCAAqC,CAAC;AACpD,cAAc,uCAAuC,CAAC;AACtD,cAAc,kCAAkC,CAAC;AACjD,cAAc,uCAAuC,CAAC;AACtD,cAAc,gDAAgD,CAAC"}

package/dist/index.js

@@ -1,24 +1,26 @@
-export * from "./commands/agents/AgentsCommands.js";
-export * from "./bin/McodaEntrypoint.js";
-export * from "./commands/cloud/CloudCommands.js";
-export * from "./commands/config/ConfigCommands.js";
-export * from "./commands/docs/DocsCommands.js";
-export * from "./commands/jobs/JobsCommands.js";
-export * from "./commands/openapi/OpenapiCommands.js";
-export * from "./commands/planning/CreateTasksCommand.js";
-export * from "./commands/backlog/BacklogCommands.js";
-export * from "./commands/backlog/TaskShowCommands.js";
-export * from "./commands/backlog/OrderTasksCommand.js";
-export * from "./commands/estimate/EstimateCommands.js";
-export * from "./commands/telemetry/TelemetryCommands.js";
-export * from "./commands/planning/RefineTasksCommand.js";
-export * from "./commands/planning/TaskSufficiencyAuditCommand.js";
-export * from "./commands/planning/SdsPreflightCommand.js";
-export * from "./commands/work/WorkOnTasksCommand.js";
-export * from "./commands/work/GatewayTrioCommand.js";
-export * from "./commands/review/CodeReviewCommand.js";
-export * from "./commands/planning/QaTasksCommand.js";
-export * from "./commands/update/UpdateCommands.js";
-export * from "./commands/routing/RoutingCommands.js";
-export * from "./commands/agents/TestAgentCommand.js";
-export * from "./commands/workspace/ProjectGuidanceCommand.js";
+export * from './commands/agents/AgentsCommands.js';
+export * from './bin/McodaEntrypoint.js';
+export * from './commands/cloud/CloudCommands.js';
+export * from './commands/config/ConfigCommands.js';
+export * from './commands/consent/ConsentCommands.js';
+export * from './commands/docs/DocsCommands.js';
+export * from './commands/jobs/JobsCommands.js';
+export * from './commands/openapi/OpenapiCommands.js';
+export * from './commands/planning/CreateTasksCommand.js';
+export * from './commands/backlog/BacklogCommands.js';
+export * from './commands/backlog/TaskShowCommands.js';
+export * from './commands/backlog/OrderTasksCommand.js';
+export * from './commands/estimate/EstimateCommands.js';
+export * from './commands/telemetry/TelemetryCommands.js';
+export * from './commands/planning/RefineTasksCommand.js';
+export * from './commands/planning/TaskSufficiencyAuditCommand.js';
+export * from './commands/planning/SdsPreflightCommand.js';
+export * from './commands/work/WorkOnTasksCommand.js';
+export * from './commands/work/GatewayTrioCommand.js';
+export * from './commands/review/CodeReviewCommand.js';
+export * from './commands/planning/QaTasksCommand.js';
+export * from './commands/update/UpdateCommands.js';
+export * from './commands/routing/RoutingCommands.js';
+export * from './commands/setup/SetupCommand.js';
+export * from './commands/agents/TestAgentCommand.js';
+export * from './commands/workspace/ProjectGuidanceCommand.js';

package/dist/install/MswarmConsentBootstrap.d.ts

@@ -0,0 +1,30 @@
+import { MswarmConfigStore } from '@mcoda/core';
+import { acceptMswarmConsent } from '../commands/consent/MswarmConsentFlow.js';
+export type ConsentBootstrapMode = 'setup' | 'postinstall' | 'install_local';
+export type DeferredBehavior = 'log' | 'error';
+export interface ConsentBootstrapPrompter {
+    close(): void;
+    question(prompt: string): Promise<string>;
+}
+export interface ConsentBootstrapOptions {
+    mode?: ConsentBootstrapMode;
+    onDeferred?: DeferredBehavior;
+    policyVersion?: string;
+    interactive?: boolean;
+    logger?: (line: string) => void;
+    prompter?: ConsentBootstrapPrompter;
+    store?: MswarmConfigStore;
+    termsText?: string;
+    acceptConsent?: typeof acceptMswarmConsent;
+}
+export interface ConsentBootstrapResult {
+    status: 'already_configured' | 'accepted' | 'deferred';
+    consentAccepted: boolean;
+    consentTokenSet: boolean;
+    clientId?: string;
+    clientType?: string;
+    policyVersion?: string;
+    message: string;
+}
+export declare function runMswarmConsentBootstrap(options?: ConsentBootstrapOptions): Promise<ConsentBootstrapResult>;
+//# sourceMappingURL=MswarmConsentBootstrap.d.ts.map

package/dist/install/MswarmConsentBootstrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MswarmConsentBootstrap.d.ts","sourceRoot":"","sources":["../../src/install/MswarmConsentBootstrap.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,mBAAmB,EAAE,MAAM,0CAA0C,CAAC;AAE/E,MAAM,MAAM,oBAAoB,GAAG,OAAO,GAAG,aAAa,GAAG,eAAe,CAAC;AAC7E,MAAM,MAAM,gBAAgB,GAAG,KAAK,GAAG,OAAO,CAAC;AAE/C,MAAM,WAAW,wBAAwB;IACvC,KAAK,IAAI,IAAI,CAAC;IACd,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC3C;AAED,MAAM,WAAW,uBAAuB;IACtC,IAAI,CAAC,EAAE,oBAAoB,CAAC;IAC5B,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,QAAQ,CAAC,EAAE,wBAAwB,CAAC;IACpC,KAAK,CAAC,EAAE,iBAAiB,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,OAAO,mBAAmB,CAAC;CAC5C;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,oBAAoB,GAAG,UAAU,GAAG,UAAU,CAAC;IACvD,eAAe,EAAE,OAAO,CAAC;IACzB,eAAe,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;CACjB;AAID,wBAAsB,yBAAyB,CAC7C,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,sBAAsB,CAAC,CA0FjC"}

package/dist/install/MswarmConsentBootstrap.js

@@ -0,0 +1,125 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import readline from 'node:readline/promises';
+import { stdin as input, stdout as output } from 'node:process';
+import { fileURLToPath } from 'node:url';
+import packageJson from '../../package.json' with { type: 'json' };
+import { MswarmConfigStore } from '@mcoda/core';
+import { acceptMswarmConsent } from '../commands/consent/MswarmConsentFlow.js';
+const ACCEPTED_RESPONSES = new Set(['accept', 'accepted', 'yes', 'y']);
+export async function runMswarmConsentBootstrap(options = {}) {
+    const logger = options.logger ?? defaultLogger;
+    const store = options.store ?? new MswarmConfigStore();
+    const state = await store.readState();
+    const consentAccepted = Boolean(state.consentAccepted);
+    const consentTokenSet = Boolean(state.consentToken?.trim());
+    if (consentAccepted && consentTokenSet) {
+        return {
+            status: 'already_configured',
+            consentAccepted,
+            consentTokenSet,
+            clientId: state.clientId,
+            clientType: state.clientType,
+            policyVersion: state.consentPolicyVersion,
+            message: 'Telemetry consent is already configured for this mcoda client.',
+        };
+    }
+    const interactive = resolveInteractive(options.interactive);
+    if (!interactive) {
+        const message = 'Telemetry consent is required before using mcoda. Run `mcoda setup` or `mcoda consent accept` in an interactive terminal.';
+        if ((options.onDeferred ?? 'error') === 'error') {
+            throw new Error(message);
+        }
+        logger(message);
+        return {
+            status: 'deferred',
+            consentAccepted,
+            consentTokenSet,
+            clientId: state.clientId,
+            clientType: state.clientType,
+            policyVersion: state.consentPolicyVersion,
+            message,
+        };
+    }
+    logger(`mcoda requires acceptance of the bundled mswarm data collection terms before ${describeMode(options.mode ?? 'setup')}.`);
+    logger('');
+    const termsText = options.termsText ?? (await readBundledTermsText());
+    for (const line of termsText.trim().split(/\r?\n/)) {
+        logger(line);
+    }
+    logger('');
+    logger('Type "accept" to agree and continue. Any other response aborts setup.');
+    const prompter = options.prompter ??
+        readline.createInterface({
+            input,
+            output,
+        });
+    try {
+        const answer = (await prompter.question('Consent> ')).trim().toLowerCase();
+        if (!ACCEPTED_RESPONSES.has(answer)) {
+            throw new Error('Telemetry consent was not accepted. mcoda cannot continue.');
+        }
+    }
+    finally {
+        prompter.close();
+    }
+    const acceptConsent = options.acceptConsent ?? acceptMswarmConsent;
+    const nextState = await acceptConsent({
+        state,
+        store,
+        policyVersion: options.policyVersion,
+        productVersion: String(packageJson.version ?? 'dev'),
+    });
+    const message = `Telemetry consent accepted for ${[
+        nextState.clientType,
+        nextState.clientId,
+    ]
+        .filter((value) => typeof value === 'string' && value.trim().length > 0)
+        .join(' ')
+        .trim()}.`.replace(/\s+\./, '.');
+    logger(message);
+    return {
+        status: 'accepted',
+        consentAccepted: Boolean(nextState.consentAccepted),
+        consentTokenSet: Boolean(nextState.consentToken?.trim()),
+        clientId: nextState.clientId,
+        clientType: nextState.clientType,
+        policyVersion: nextState.consentPolicyVersion,
+        message,
+    };
+}
+async function readBundledTermsText() {
+    const termsPath = resolveBundledTermsPath();
+    try {
+        return await fs.readFile(termsPath, 'utf8');
+    }
+    catch {
+        return [
+            'Mswarm Data Collection Terms And Consent',
+            '',
+            'Consent is required to use mcoda.',
+            'By accepting, you allow anonymous or account-bound telemetry upload to mswarm, including consent proof, product activity, and agent rating data as described in the bundled terms document.',
+            'You may later revoke consent or request deletion with `mcoda consent revoke` or `mcoda consent request-deletion`.',
+        ].join('\n');
+    }
+}
+function resolveBundledTermsPath() {
+    return path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..', '..', 'MSWARM_DATA_COLLECTION_TERMS.md');
+}
+function resolveInteractive(explicit) {
+    if (explicit !== undefined) {
+        return explicit;
+    }
+    return Boolean(process.stdin.isTTY && process.stdout.isTTY && !process.env.CI);
+}
+function describeMode(mode) {
+    if (mode === 'postinstall')
+        return 'using the installed mcoda CLI';
+    if (mode === 'install_local')
+        return 'completing the local mcoda install helper';
+    return 'continuing mcoda setup';
+}
+function defaultLogger(line) {
+    // eslint-disable-next-line no-console
+    console.log(line);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcoda",
-  "version": "0.1.38",
+  "version": "0.1.41",
   "description": "Local-first CLI for planning, documentation, and execution workflows with agent assistance.",
   "type": "module",
   "main": "dist/index.js",
@@ -10,8 +10,10 @@
   },
   "files": [
     "dist",
+    "scripts",
     "!dist/**/__tests__/**",
     "!dist/**/*.test.*",
+    "MSWARM_DATA_COLLECTION_TERMS.md",
     "README.md",
     "CHANGELOG.md",
     "LICENSE"
@@ -45,16 +47,17 @@
   },
   "dependencies": {
     "yaml": "^2.4.2",
-    "@mcoda/core": "0.1.38",
-    "@mcoda/shared": "0.1.38"
+    "@mcoda/core": "0.1.41",
+    "@mcoda/shared": "0.1.41"
   },
   "devDependencies": {
-    "@mcoda/db": "0.1.38",
-    "@mcoda/integrations": "0.1.38"
+    "@mcoda/db": "0.1.41",
+    "@mcoda/integrations": "0.1.41"
   },
   "scripts": {
     "build": "tsc -p tsconfig.json",
     "lint": "echo \"lint not configured\"",
+    "postinstall": "node ./scripts/postinstall.js",
     "test": "pnpm run build && node ../../scripts/run-node-tests.js dist",
     "pack:verify": "node --test test/packaging_guardrails.test.js"
   }