@localizeaso/cli 0.1.0-preview.0

package/packages/asc-shared/dist/monetization-boundary.js

@@ -0,0 +1,365 @@
+export const LOCALIZEASO_AGENT_PASS_PACKAGING_DECISION = {
+    defaultPaidPlan: 'agent',
+    defaultPaidPlanLabel: 'Agent Pass',
+    freeToolRole: 'acquisition_and_trust',
+    recommendedFreeTool: 'pricing_parity_cli',
+    pricingParityCliRole: 'Use pricing parity, Astro CSV import, keyword-context conversion, and manifest generation as the useful free/OSS CLI wedge; charge when the user creates a persistent LocalizeASO review job with consent UI, history, Figma/apply handoffs, app slots, or hosted submit.',
+    openSourceBoundary: 'Open-source local setup, keyword conversion, pricing-parity manifests, prompt/template generation, and already-approved local asc handoff helpers. Keep backend persistence, review history, consent screens, Figma apply plans, hosted AI, app slots, and hosted submit in paid LocalizeASO passes.',
+    primaryRevenueSurface: 'Human review/consent screens with current/proposed/final diffs, keyword evidence, warnings, approval receipts, review history, Figma apply plans, app slots, local asc handoffs after approval, and optional hosted AI or hosted submit convenience.',
+    freeToolIncludes: [
+        'local setup',
+        'Astro/CSV keyword conversion',
+        'prompt/template generation',
+        'pricing parity manifests',
+    ],
+    byoPaidIncludes: [
+        'persistent review jobs',
+        'human review/consent screens with diffs and signal evidence',
+        'review history',
+        'approval receipts',
+        'reviewer feedback',
+        'Figma apply plans',
+        'app slots',
+        'local asc handoffs after human approval',
+    ],
+    hostedUpsellIncludes: [
+        'hosted submit-only pass for BYO/Codex proposals after human approval',
+        'LocalizeASO-hosted AI proposal generation',
+        'hosted App Store Connect upload/submit convenience after human approval',
+        'larger app or team coverage',
+    ],
+    defaultPricingModel: 'one_time_or_lifetime_byo_agent_pass',
+    recommendedOneTimePrices: {
+        agent: '$29',
+        submit: '$39',
+        launch: '$49',
+        global: '$149',
+        portfolio: '$299',
+    },
+    avoidPositioning: [
+        'usage-based LocalizeASO AI pricing for BYO Codex/AI runs',
+        'promising hosted submit inside Agent Pass',
+        'requiring App Store Connect credentials for proposal review',
+    ],
+};
+export function localizeAsoAgentPassPackagingDecision() {
+    return {
+        ...LOCALIZEASO_AGENT_PASS_PACKAGING_DECISION,
+        freeToolIncludes: [...LOCALIZEASO_AGENT_PASS_PACKAGING_DECISION.freeToolIncludes],
+        byoPaidIncludes: [...LOCALIZEASO_AGENT_PASS_PACKAGING_DECISION.byoPaidIncludes],
+        hostedUpsellIncludes: [...LOCALIZEASO_AGENT_PASS_PACKAGING_DECISION.hostedUpsellIncludes],
+        recommendedOneTimePrices: {
+            ...LOCALIZEASO_AGENT_PASS_PACKAGING_DECISION.recommendedOneTimePrices,
+        },
+        avoidPositioning: [...LOCALIZEASO_AGENT_PASS_PACKAGING_DECISION.avoidPositioning],
+    };
+}
+function buildLocalizeAsoPackageMatrix(packaging) {
+    const prices = packaging.recommendedOneTimePrices;
+    return [
+        {
+            id: 'free_local_cli',
+            label: 'Free/local CLI',
+            distribution: 'free',
+            purchaseModel: 'free_preview',
+            aiCostOwner: 'none',
+            appStoreConnectCredentialMode: 'not_required',
+            persistentReviewJobs: false,
+            reviewHistory: false,
+            figmaApplyPlans: false,
+            appSlotsIncluded: false,
+            appSlotLimit: 0,
+            hostedAi: false,
+            hostedSubmit: false,
+            localAscHandoffAfterApproval: true,
+            includes: [
+                'pricing parity JSON and manifest conversion',
+                'Astro/CSV keyword context conversion',
+                'prompt and proposal-template generation from exported bundles',
+                'already-approved local asc handoff helpers',
+            ],
+            excludes: [
+                'persistent backend review jobs',
+                'human consent screen persistence',
+                'review history',
+                'Figma apply plans',
+                'hosted AI',
+                'hosted App Store Connect submit',
+            ],
+            bestFor: 'Acquisition, trust, and local setup before the user creates a persisted LocalizeASO review job.',
+        },
+        {
+            id: 'agent_pass',
+            label: 'Agent Pass',
+            distribution: 'paid',
+            purchaseModel: 'one_time_or_lifetime',
+            priceAnchor: prices.agent,
+            aiCostOwner: 'customer',
+            appStoreConnectCredentialMode: 'local_human_after_approval',
+            persistentReviewJobs: true,
+            reviewHistory: true,
+            figmaApplyPlans: true,
+            appSlotsIncluded: true,
+            appSlotLimit: 1,
+            hostedAi: false,
+            hostedSubmit: false,
+            localAscHandoffAfterApproval: true,
+            includes: [
+                'BYO Codex/AI proposal workflow',
+                'metadata, keyword, screenshot, and pricing review jobs',
+                'human review/consent screens with diffs and signal evidence',
+                'review history and reviewer feedback',
+                'Figma apply plans after approval',
+                'paid app slot for persisted review work',
+                'local asc handoffs after approval',
+            ],
+            excludes: ['LocalizeASO-hosted AI proposal generation', 'hosted App Store Connect submit'],
+            bestFor: 'Developers who already pay for Codex or another AI agent and want LocalizeASO to store the review, consent, history, and handoff layer.',
+        },
+        {
+            id: 'submit_pass',
+            label: 'Submit Pass',
+            distribution: 'paid',
+            purchaseModel: 'one_time_hosted_submit_credit_or_subscription',
+            priceAnchor: prices.submit,
+            aiCostOwner: 'customer',
+            appStoreConnectCredentialMode: 'hosted_after_approval',
+            persistentReviewJobs: true,
+            reviewHistory: true,
+            figmaApplyPlans: true,
+            appSlotsIncluded: true,
+            appSlotLimit: 1,
+            hostedAi: false,
+            hostedSubmit: true,
+            localAscHandoffAfterApproval: true,
+            includes: [
+                'BYO Codex/AI proposals',
+                'review history and consent screens',
+                'paid app slot for persisted review work',
+                'hosted App Store Connect upload/submit after approval',
+            ],
+            excludes: ['LocalizeASO-hosted AI proposal generation', 'submit before human approval'],
+            bestFor: 'Users who want to keep proposal generation on their own AI subscription but pay LocalizeASO for approved hosted App Store Connect convenience.',
+        },
+        {
+            id: 'hosted_ai_pass',
+            label: 'Hosted AI Pass',
+            distribution: 'paid',
+            purchaseModel: 'one_time_hosted_ai_credit_or_subscription',
+            priceAnchor: prices.launch,
+            aiCostOwner: 'localizeaso',
+            appStoreConnectCredentialMode: 'local_human_after_approval',
+            persistentReviewJobs: true,
+            reviewHistory: true,
+            figmaApplyPlans: true,
+            appSlotsIncluded: true,
+            appSlotLimit: 1,
+            hostedAi: true,
+            hostedSubmit: false,
+            localAscHandoffAfterApproval: true,
+            includes: [
+                'LocalizeASO-hosted AI proposal generation',
+                'review history and consent screens',
+                'paid app slot for persisted review work',
+                'local asc handoffs after approval',
+            ],
+            excludes: ['hosted App Store Connect submit unless the chosen pass includes it'],
+            bestFor: 'Users who want LocalizeASO to spend hosted AI for proposal generation but do not need hosted submit convenience.',
+        },
+        {
+            id: 'hosted_full_pass',
+            label: 'Hosted LocalizeASO Pass',
+            distribution: 'paid',
+            purchaseModel: 'one_time_hosted_credit_or_subscription',
+            priceAnchor: prices.global,
+            aiCostOwner: 'localizeaso',
+            appStoreConnectCredentialMode: 'hosted_after_approval',
+            persistentReviewJobs: true,
+            reviewHistory: true,
+            figmaApplyPlans: true,
+            appSlotsIncluded: true,
+            appSlotLimit: 2,
+            hostedAi: true,
+            hostedSubmit: true,
+            localAscHandoffAfterApproval: true,
+            includes: [
+                'LocalizeASO-hosted AI proposal generation',
+                'review history and consent screens',
+                'Figma apply plans after approval',
+                'paid app slot for persisted review work',
+                'hosted App Store Connect upload/submit after approval',
+            ],
+            excludes: ['approval-free apply or submit'],
+            bestFor: 'Teams that want both hosted proposal generation and hosted App Store Connect convenience after human approval.',
+        },
+        {
+            id: 'portfolio_pass',
+            label: 'Portfolio Pass',
+            distribution: 'paid',
+            purchaseModel: 'one_time_hosted_credit_or_subscription',
+            priceAnchor: prices.portfolio,
+            aiCostOwner: 'localizeaso',
+            appStoreConnectCredentialMode: 'hosted_after_approval',
+            persistentReviewJobs: true,
+            reviewHistory: true,
+            figmaApplyPlans: true,
+            appSlotsIncluded: true,
+            appSlotLimit: 10,
+            hostedAi: true,
+            hostedSubmit: true,
+            localAscHandoffAfterApproval: true,
+            includes: [
+                'LocalizeASO-hosted AI proposal generation',
+                'portfolio review history and consent screens',
+                'Figma apply plans after approval',
+                'up to 10 paid app slots for persisted review work',
+                'hosted App Store Connect upload/submit after approval',
+            ],
+            excludes: ['approval-free apply or submit'],
+            bestFor: 'Developers or teams managing a portfolio of App Store listings that need hosted proposal generation, history, and post-approval submit convenience.',
+        },
+    ];
+}
+function buildLocalizeAsoValueLedger() {
+    return {
+        byoAgentOneTime: {
+            purchaseModel: 'cheap_one_time_or_lifetime',
+            aiCostOwner: 'customer',
+            includes: [
+                'BYO Codex/AI proposal generation',
+                'persistent backend review jobs',
+                'review history and approval receipts',
+                'human review UI with current/proposed/final diffs',
+                'Figma apply-plan comfort after approval',
+                'paid app slot for persisted review work',
+                'local asc handoff runbooks after approval',
+            ],
+            excludes: [
+                'LocalizeASO-hosted AI spend',
+                'hosted App Store Connect upload/submit convenience',
+                'approval-free apply or submit',
+            ],
+        },
+        hostedConvenience: {
+            purchaseModel: 'paid_hosted_credit_or_subscription',
+            aiCostOwner: 'localizeaso_or_customer_for_submit_only',
+            includes: [
+                'LocalizeASO-hosted proposal generation when the pass includes hosted AI',
+                'hosted backend review history and reviewer feedback',
+                'Figma comfort handoffs and apply plans after approval',
+                'paid app slots for persisted review work',
+                'hosted App Store Connect upload/submit convenience after approval',
+            ],
+            excludes: [
+                'using hosted AI budget for BYO-only Agent Pass runs',
+                'collecting App Store Connect credentials before they are needed',
+                'submit, schedule, publish, or apply before human approval',
+            ],
+        },
+        approvalGate: {
+            appliesBefore: 'figma_apply_or_app_store_connect_submit',
+            required: true,
+            agentCanBypass: false,
+            notes: [
+                'agents may generate proposals and refinements only',
+                'humans must approve the exact apply plan before Figma apply or App Store Connect submit',
+                'post-approval runbooks stay human-only even when hosted convenience is available',
+            ],
+        },
+    };
+}
+export function buildLocalizeAsoMonetizationBoundary(reviewKind, options = {}) {
+    const packaging = localizeAsoAgentPassPackagingDecision();
+    return {
+        kind: 'localizeaso_monetization_boundary',
+        reviewKind,
+        ...(options.reviewSurface ? { reviewSurface: options.reviewSurface } : {}),
+        freeLocalDistribution: {
+            purpose: 'OSS/free CLI distribution and agent onboarding',
+            recommendedFreeTool: packaging.recommendedFreeTool,
+            pricingParityCliRole: packaging.pricingParityCliRole,
+            openSourceBoundary: packaging.openSourceBoundary,
+            includes: [
+                'local pricing-parity manifest conversion',
+                'local Astro/CSV keyword-context conversion',
+                'local prompt and proposal-template generation from already exported bundles',
+                'local asc handoff execution after a human has approved exported changes',
+            ],
+            excludes: [
+                'persistent LocalizeASO review jobs',
+                'backend review history',
+                'Figma apply-plan handoff',
+                'hosted AI proposal runs',
+                'hosted App Store Connect upload/submit convenience',
+            ],
+        },
+        localAgentSafe: [
+            'pricing-parity-manifest',
+            'keyword-context-from-csv',
+            'keyword-prompt',
+            'proposal-template',
+        ],
+        passRequired: {
+            reviewJobs: 'Agent Pass or hosted LocalizeASO pass',
+            reviewHistory: 'Agent Pass or hosted LocalizeASO pass',
+            figmaPlugin: 'Agent Pass or hosted LocalizeASO pass',
+            pricingReview: 'Agent Pass or hosted LocalizeASO pass with pricing review access',
+            appSlots: 'Agent Pass or hosted LocalizeASO pass with enough app slots',
+            hostedAi: 'hosted LocalizeASO pass only',
+            hostedSubmit: 'Submit Pass or hosted LocalizeASO pass',
+        },
+        agentPass: {
+            purchaseModel: 'one_time_or_lifetime',
+            aiCostOwner: 'customer',
+            hostedAiIncluded: false,
+            submitMode: 'local_asc_handoff_after_human_approval',
+            bestFor: 'Developers who bring Codex, another AI agent, Astro keyword research, and local asc/App Store Connect tooling.',
+        },
+        hostedPass: {
+            purchaseModel: 'one_time_hosted_credit_or_subscription',
+            aiCostOwner: 'localizeaso',
+            hostedAiIncluded: true,
+            submitMode: 'hosted_submit_after_human_approval',
+            bestFor: 'Teams that want both LocalizeASO-hosted proposal runs and hosted App Store Connect submit convenience.',
+        },
+        hostedSubmitPass: {
+            purchaseModel: 'one_time_hosted_submit_credit_or_subscription',
+            aiCostOwner: 'customer',
+            hostedAiIncluded: false,
+            submitMode: 'hosted_submit_after_human_approval',
+            bestFor: 'Developers who bring Codex or another AI agent for proposals but want LocalizeASO to perform the approved App Store Connect upload/submit step.',
+        },
+        hostedAiPass: {
+            purchaseModel: 'one_time_hosted_ai_credit_or_subscription',
+            aiCostOwner: 'localizeaso',
+            hostedAiIncluded: true,
+            submitMode: 'local_asc_or_hosted_submit_after_human_approval',
+            bestFor: 'Users who want LocalizeASO-hosted proposal generation; hosted submit remains a separate consent-gated capability unless bundled.',
+        },
+        revenueModel: {
+            defaultMotion: 'Use the free/open CLI as acquisition and trust, sell Agent Pass as the default BYO-agent product, and reserve hosted passes for LocalizeASO-paid AI or hosted App Store Connect convenience.',
+            freeSurface: 'Keep local setup, Astro CSV conversion, prompt/template generation, pricing-parity manifests, and already-approved local asc handoffs useful without checkout.',
+            paidSurface: 'Charge for persistent review jobs, human review/consent screens with diffs and signal evidence, approval history, reviewer feedback, Figma apply plans, app slots, hosted proposal allowance, and hosted upload/submit convenience.',
+            primaryRevenueSurface: packaging.primaryRevenueSurface,
+            recommendedDefaultPlan: 'agent',
+            upsellTriggers: [
+                'customer wants LocalizeASO to run hosted AI proposal generation',
+                'customer wants hosted App Store Connect submit convenience without LocalizeASO-hosted AI',
+                'customer wants hosted App Store Connect upload/submit convenience',
+                'customer needs more than one app slot or portfolio-level coverage',
+            ],
+            avoid: [
+                'charging usage-based LocalizeASO AI fees when the customer brings Codex or another AI agent',
+                'including hosted upload/submit in Agent Pass',
+                'claiming the customer Codex subscription covers LocalizeASO backend or hosted submit costs',
+            ],
+        },
+        packageMatrix: buildLocalizeAsoPackageMatrix(packaging),
+        valueLedger: buildLocalizeAsoValueLedger(),
+        packagingDecision: packaging,
+        recommendedOneTimePrices: packaging.recommendedOneTimePrices,
+        pricingGuidance: 'Keep the CLI/free surface useful for acquisition, sell Agent Pass for BYO human review, approval history, signal evidence, Figma handoffs, and app slots, offer hosted submit as a separate no-hosted-AI convenience pass, and upsell hosted AI only when LocalizeASO pays for proposal generation.',
+        appStoreConnectCredentials: 'Not required for BYO proposal generation, keyword import, or opening the human review/approval screen; only needed for hosted submit convenience or a human-run local asc handoff after explicit approval.',
+        agentInstruction: 'Use local agent-safe steps for research and proposals. Choose Agent Pass for BYO review/history/Figma handoffs, hosted submit pass for BYO proposals plus LocalizeASO App Store Connect convenience, or hosted AI pass when LocalizeASO should spend hosted AI.',
+    };
+}

package/packages/asc-shared/dist/post-approval-paths.d.ts

@@ -0,0 +1,30 @@
+import type { LocalizeAsoAgentPassPackagingDecision } from './monetization-boundary.js';
+export type LocalizeAsoPostApprovalCredentialMode = 'not_required' | 'local_human' | 'external_human_upload' | 'localizeaso_connected';
+export type LocalizeAsoPostApprovalMonetizationBoundary = {
+    requiresLocalizeAsoPass: true;
+    requiredLocalizeAsoCapabilities: ReadonlyArray<'byoAgent' | 'reviewHistory' | 'figmaPlugin' | 'pricingReview' | 'appStoreSubmit'>;
+    requiresHostedAi: false;
+    requiresHostedSubmitPass: boolean;
+    appStoreConnectCredentialMode: LocalizeAsoPostApprovalCredentialMode;
+    revenueBoundary: 'paid_review_handoff' | 'paid_figma_apply_handoff' | 'hosted_submit_convenience';
+    packageLabel?: string;
+    packageGuidance?: string;
+    packagingDecision?: LocalizeAsoAgentPassPackagingDecision;
+    notes: string[];
+};
+export type LocalizeAsoApplyPlanFingerprintRequirement = {
+    required: true;
+    source: 'apply_plan_export' | 'approval_receipt';
+    sourceCommand: string;
+    flag: '--expected-apply-plan-fingerprint';
+    protectedCommandsPreferred: true;
+    includedInCommands: boolean;
+    applyPlanFingerprint?: string;
+    note: string;
+};
+export declare const LOCALIZEASO_APPROVAL_PROTECTED_ACTION_BOUNDARY = "Approval only locks this reviewed proposal. Figma apply, metadata/keyword apply, pricing export or scheduling, App Store upload/submit, and applied/submitted status changes still require a separate explicit human post-approval action. Review rejection is a separate human-only review action with explicit rejection consent.";
+export declare const LOCALIZEASO_POST_APPROVAL_PROTECTED_ACTION_BOUNDARY = "Approval only locks this reviewed proposal. Figma apply, metadata/keyword apply, pricing export or scheduling, App Store upload/submit, and applied/submitted status changes require a separate explicit human post-approval action. Review rejection uses explicit human rejection consent instead.";
+export declare const LOCALIZEASO_REJECTION_PROTECTED_ACTION_BOUNDARY = "Review rejection is a separate human-only review action. It requires explicit human rejection consent after reviewing the proposal context and does not approve, apply, export, schedule, submit, or mark approved changes.";
+export declare const LOCALIZEASO_DIRECT_ASC_MUTATION_PROTECTED_ACTION_BOUNDARY = "Direct App Store Connect mutations outside a fingerprinted LocalizeASO review handoff require explicit human direct-mutation consent after reviewing the final payload. Review rejection is a separate human-only review action with explicit rejection consent.";
+export declare function postApprovalPathModeGuidance(mode?: string | null): "Use when App Store Connect credentials should stay local; inspect the approved export or CSV, verify the approved apply-plan fingerprint, and run asc from the human workstation after explicit human post-approval consent." | "Use to update LocalizeASO draft state or review history after approval; require explicit human post-approval consent plus the approved apply-plan fingerprint, and use another path for hosted App Store submit." | "Use only when the pass includes hosted submit and App Store Connect is connected; LocalizeASO performs the submit step only after human approval, explicit post-approval consent, and the approved apply-plan fingerprint." | "Use to update the LocalizeASO keyword inventory after approval with explicit human post-approval consent and the approved apply-plan fingerprint; keyword-store reviews do not submit anything to App Store Connect." | "Use inside the Figma plugin only after explicit human post-approval consent and after the approved apply preview matches the app, file, proposal version, apply-plan fingerprint, layer count, and skipped targets." | "Use after approved screenshots were uploaded by a human-run workflow. The status command only records that the external upload finished; hosted LocalizeASO upload or reorder requires the concrete applied/submitted screenshot review job ID, approved proposal ID/version, and the approved apply-plan fingerprint, while local asc, Transporter, or web UI uploads can keep App Store Connect credentials local." | "Use only to record the result of an external human-run post-approval step.";
+//# sourceMappingURL=post-approval-paths.d.ts.map

package/packages/asc-shared/dist/post-approval-paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"post-approval-paths.d.ts","sourceRoot":"","sources":["../src/post-approval-paths.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qCAAqC,EAAE,MAAM,4BAA4B,CAAC;AAExF,MAAM,MAAM,qCAAqC,GAC7C,cAAc,GACd,aAAa,GACb,uBAAuB,GACvB,uBAAuB,CAAC;AAE5B,MAAM,MAAM,2CAA2C,GAAG;IACxD,uBAAuB,EAAE,IAAI,CAAC;IAC9B,+BAA+B,EAAE,aAAa,CAC1C,UAAU,GACV,eAAe,GACf,aAAa,GACb,eAAe,GACf,gBAAgB,CACnB,CAAC;IACF,gBAAgB,EAAE,KAAK,CAAC;IACxB,wBAAwB,EAAE,OAAO,CAAC;IAClC,6BAA6B,EAAE,qCAAqC,CAAC;IACrE,eAAe,EACX,qBAAqB,GACrB,0BAA0B,GAC1B,2BAA2B,CAAC;IAChC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,iBAAiB,CAAC,EAAE,qCAAqC,CAAC;IAC1D,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,0CAA0C,GAAG;IACvD,QAAQ,EAAE,IAAI,CAAC;IACf,MAAM,EAAE,mBAAmB,GAAG,kBAAkB,CAAC;IACjD,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,mCAAmC,CAAC;IAC1C,0BAA0B,EAAE,IAAI,CAAC;IACjC,kBAAkB,EAAE,OAAO,CAAC;IAC5B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,eAAO,MAAM,8CAA8C,wUAC4Q,CAAC;AAExU,eAAO,MAAM,mDAAmD,ySACwO,CAAC;AAEzS,eAAO,MAAM,+CAA+C,gOACmK,CAAC;AAEhO,eAAO,MAAM,yDAAyD,qQAC8L,CAAC;AAErQ,wBAAgB,4BAA4B,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,+iDAoBhE"}

package/packages/asc-shared/dist/post-approval-paths.js

@@ -0,0 +1,25 @@
+export const LOCALIZEASO_APPROVAL_PROTECTED_ACTION_BOUNDARY = 'Approval only locks this reviewed proposal. Figma apply, metadata/keyword apply, pricing export or scheduling, App Store upload/submit, and applied/submitted status changes still require a separate explicit human post-approval action. Review rejection is a separate human-only review action with explicit rejection consent.';
+export const LOCALIZEASO_POST_APPROVAL_PROTECTED_ACTION_BOUNDARY = 'Approval only locks this reviewed proposal. Figma apply, metadata/keyword apply, pricing export or scheduling, App Store upload/submit, and applied/submitted status changes require a separate explicit human post-approval action. Review rejection uses explicit human rejection consent instead.';
+export const LOCALIZEASO_REJECTION_PROTECTED_ACTION_BOUNDARY = 'Review rejection is a separate human-only review action. It requires explicit human rejection consent after reviewing the proposal context and does not approve, apply, export, schedule, submit, or mark approved changes.';
+export const LOCALIZEASO_DIRECT_ASC_MUTATION_PROTECTED_ACTION_BOUNDARY = 'Direct App Store Connect mutations outside a fingerprinted LocalizeASO review handoff require explicit human direct-mutation consent after reviewing the final payload. Review rejection is a separate human-only review action with explicit rejection consent.';
+export function postApprovalPathModeGuidance(mode) {
+    if (mode === 'local_asc' || mode === 'local_asc_export') {
+        return 'Use when App Store Connect credentials should stay local; inspect the approved export or CSV, verify the approved apply-plan fingerprint, and run asc from the human workstation after explicit human post-approval consent.';
+    }
+    if (mode === 'localizeaso_draft') {
+        return 'Use to update LocalizeASO draft state or review history after approval; require explicit human post-approval consent plus the approved apply-plan fingerprint, and use another path for hosted App Store submit.';
+    }
+    if (mode === 'hosted_submit') {
+        return 'Use only when the pass includes hosted submit and App Store Connect is connected; LocalizeASO performs the submit step only after human approval, explicit post-approval consent, and the approved apply-plan fingerprint.';
+    }
+    if (mode === 'keyword_store') {
+        return 'Use to update the LocalizeASO keyword inventory after approval with explicit human post-approval consent and the approved apply-plan fingerprint; keyword-store reviews do not submit anything to App Store Connect.';
+    }
+    if (mode === 'figma_apply') {
+        return 'Use inside the Figma plugin only after explicit human post-approval consent and after the approved apply preview matches the app, file, proposal version, apply-plan fingerprint, layer count, and skipped targets.';
+    }
+    if (mode === 'app_store_upload') {
+        return 'Use after approved screenshots were uploaded by a human-run workflow. The status command only records that the external upload finished; hosted LocalizeASO upload or reorder requires the concrete applied/submitted screenshot review job ID, approved proposal ID/version, and the approved apply-plan fingerprint, while local asc, Transporter, or web UI uploads can keep App Store Connect credentials local.';
+    }
+    return 'Use only to record the result of an external human-run post-approval step.';
+}

package/packages/asc-shared/dist/review-gate-summary.d.ts

@@ -0,0 +1,166 @@
+import type { AppStoreFieldReviewProposal, AppStoreFieldReviewTarget } from './app-store-review.js';
+import type { ScreenshotReviewProposalPayload } from './screenshot-review.js';
+export type ReviewSignalAuditSummary = {
+    totalTargets: number;
+    keywordMappingNotApplicableCount: number;
+    missingKeywordMappingCount: number;
+    missingRationaleCount: number;
+    noWarningsReportedCount: number;
+    targetsNeedingAttentionCount: number;
+    allTargetsHaveReviewSignals: boolean;
+};
+export type ReviewSignalGapSummaryLineInput = {
+    keywordMappingNotApplicableCount?: number | null;
+    missingKeywordMappingCount?: number | null;
+    missingRationaleCount?: number | null;
+    noWarningsReportedCount?: number | null;
+    screenshotEvidenceGapCount?: number | null;
+};
+export declare function formatReviewSignalGapSummaryLine(input: ReviewSignalGapSummaryLineInput, options?: {
+    keywordMappingNotApplicable?: boolean;
+    includeNoGaps?: boolean;
+}): string;
+export type ReviewSignalAuditInput = {
+    assignedKeywords?: string[] | null;
+    unassignedKeywords?: string[] | null;
+    warnings?: string[] | null;
+    rationale?: string | null;
+    keywordMappingNotApplicable?: boolean | null;
+};
+export type ReviewSignalContract = {
+    kind: 'localizeaso_review_signal_contract';
+    requiredPerTarget: Array<'assignedKeywords' | 'unassignedKeywords' | 'warnings' | 'rationale'>;
+    requiredPerTargetLabels?: string[];
+    requiredReviewContext?: string[];
+    requiredReviewContextLabels?: string[];
+    targetLevels: string[];
+    emptySignalsMeanConsidered: true;
+    qualityGates: {
+        missingKeywordMapping: string;
+        missingRationale: string;
+        noWarningsReported: string;
+    };
+    agentInstruction: string;
+    humanReviewInstruction: string;
+};
+export declare function normalizeReviewSignalList(values: string[] | undefined | null): string[];
+export declare function reviewSignalCount(values: string[] | undefined | null): number;
+export declare function uniqueReviewSignalCount(values: Array<string[] | undefined | null>): number;
+export declare function hasReviewSignals(values: string[] | undefined | null): boolean;
+export declare function reviewSignalAudit(input: ReviewSignalAuditInput): {
+    hasAssignedKeywords: boolean;
+    hasUnassignedKeywords: boolean;
+    keywordMappingNotApplicable: boolean;
+    hasKeywordMapping: boolean;
+    hasWarnings: boolean;
+    hasRationale: boolean;
+    missingReviewSignals: string[];
+    noWarningsReported: boolean;
+    needsReviewerAttention: boolean;
+};
+export declare function reviewSignalAuditSummary(inputs: ReviewSignalAuditInput[]): ReviewSignalAuditSummary;
+export declare function screenshotReviewSignalAuditInputs(payload: ScreenshotReviewProposalPayload): ReviewSignalAuditInput[];
+export declare function screenshotReviewSignalAuditSummary(payload: ScreenshotReviewProposalPayload): ReviewSignalAuditSummary;
+export declare function fieldReviewSignalAuditInputs(proposal: AppStoreFieldReviewProposal): ReviewSignalAuditInput[];
+export declare function fieldReviewSignalAuditSummary(proposal: AppStoreFieldReviewProposal): ReviewSignalAuditSummary;
+export type ReviewGateSummary = {
+    kind: 'localizeaso_review_readiness_gate';
+    reviewKind: 'screenshots' | 'field';
+    ready: boolean;
+    humanDecisionGate: 'complete' | 'pending';
+    signalGate: 'complete' | 'attention_required' | 'unknown';
+    pendingTargetCount: number;
+    targetsNeedingAttentionCount: number;
+    keywordMappingNotApplicableCount: number;
+    missingKeywordMappingCount: number;
+    missingRationaleCount: number;
+    noWarningsReportedCount: number;
+    screenshotEvidenceGapCount?: number;
+    screenshotMissingTargetCount?: number;
+    screenshotFallbackOnlyTargetCount?: number;
+    screenshotContextOnlyTargetCount?: number;
+    screenshotStrongEvidenceTargetCount?: number;
+    screenshotWeakEvidenceTargetCount?: number;
+    warnings: string[];
+    agentInstruction: string;
+};
+export type ReviewReadinessBoundary = {
+    kind: 'localizeaso_readiness_boundary';
+    reviewKind: ReviewGateSummary['reviewKind'];
+    readOnly: true;
+    mutatesReviewData: false;
+    mutatesAppStoreConnect: false;
+    approvalGranted: false;
+    postApprovalActionAllowed: false;
+    requiresHumanApprovalConsent: true;
+    requiresHumanPostApprovalConsentForApplySubmit: true;
+    protectedActions: string[];
+    nextHumanAction: string;
+    agentInstruction: string;
+};
+export type FieldReviewFinalValueBlockingIssue = {
+    target: AppStoreFieldReviewTarget;
+    code: 'INVALID_PRICING_FINAL_VALUE' | 'INVALID_METADATA_FINAL_VALUE' | 'INVALID_KEYWORD_FINAL_VALUE';
+    message: string;
+};
+export type FieldReviewFinalValueGate = {
+    kind: 'localizeaso_field_final_value_gate';
+    ready: boolean;
+    status: 'clear' | 'blocked';
+    blockingIssueCount: number;
+    warnings: string[];
+    agentInstruction: string;
+};
+export type ReadinessReviewGate = {
+    kind: 'localizeaso_readiness_review_gate';
+    phase: 'readiness_inspection';
+    reviewKind: ReviewGateSummary['reviewKind'];
+    ready: boolean;
+    humanReviewRequired: true;
+    readOnly: boolean;
+    approvalGranted: boolean;
+    postApprovalActionAllowed: boolean;
+    pendingTargetCount?: number;
+    humanDecisionGate?: ReviewGateSummary['humanDecisionGate'];
+    signalGate?: ReviewGateSummary['signalGate'];
+    keywordMappingNotApplicableCount?: number;
+    screenshotEvidenceGapCount?: number;
+    screenshotMissingTargetCount?: number;
+    screenshotFallbackOnlyTargetCount?: number;
+    screenshotContextOnlyTargetCount?: number;
+    screenshotStrongEvidenceTargetCount?: number;
+    screenshotWeakEvidenceTargetCount?: number;
+    finalValueGateStatus?: FieldReviewFinalValueGate['status'];
+    finalValueBlockingIssueCount?: number;
+    warnings: string[];
+    nextHumanAction: string;
+    agentInstruction: string;
+};
+export declare function buildReviewGateSummary(params: {
+    reviewKind: ReviewGateSummary['reviewKind'];
+    ready: boolean;
+    pendingTargetCount: number;
+    signalAudit?: ReviewSignalAuditSummary | null;
+    screenshotEvidence?: {
+        missingTargetCount?: number | null;
+        fallbackOnlyTargetCount?: number | null;
+        contextOnlyTargetCount?: number | null;
+        strongEvidenceTargetCount?: number | null;
+        weakEvidenceTargetCount?: number | null;
+    } | null;
+}): ReviewGateSummary;
+export declare function buildReviewReadinessBoundary(params: {
+    reviewKind: ReviewGateSummary['reviewKind'];
+    ready: boolean;
+}): ReviewReadinessBoundary;
+export declare function summarizeFieldReviewFinalValueBlockingIssue(issue: FieldReviewFinalValueBlockingIssue | unknown, index?: number): string;
+export declare function buildFieldReviewFinalValueGate(blockingIssues: FieldReviewFinalValueBlockingIssue[]): FieldReviewFinalValueGate;
+export declare function buildReadinessReviewGate(params: {
+    reviewKind: ReviewGateSummary['reviewKind'];
+    ready?: boolean;
+    reviewGateSummary?: ReviewGateSummary | null;
+    readinessBoundary?: ReviewReadinessBoundary | null;
+    finalValueGate?: FieldReviewFinalValueGate | null;
+    pendingTargetCount?: number;
+}): ReadinessReviewGate;
+//# sourceMappingURL=review-gate-summary.d.ts.map

package/packages/asc-shared/dist/review-gate-summary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-gate-summary.d.ts","sourceRoot":"","sources":["../src/review-gate-summary.ts"],"names":[],"mappings":"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"}