@contextecf/guardian-cli 0.1.2 → 0.1.4

package/dist/packages/guardian-cli/src/runtime.d.ts

@@ -1,13 +1,16 @@
 import type { Writable } from 'node:stream';
 import { type PolicyPackMarketplaceManifest } from '@contextecf/personal-fabric-contracts';
 import { SQLitePersonalFabricStore, type PersonalFabricDataImportResult, type PersonalFabricMutableDataDeleteResult, type SQLitePersonalFabricBackupResult } from '@contextecf/personal-fabric-store';
-export declare const GUARDIAN_CLI_VERSION = "0.1.2";
+export declare const GUARDIAN_CLI_VERSION = "0.1.4";
 export declare const GUARDIAN_PROFILE_SCHEMA_VERSION = "contextecf/project-guardian-profile/v1";
 export declare const GUARDIAN_NPM_PACKAGE_NAME = "@contextecf/guardian-cli";
+export declare const GUARDIAN_NPM_REGISTRY = "https://registry.npmjs.org/";
 export declare const GUARDIAN_GLOBAL_INSTALL_COMMAND = "npm install -g @contextecf/guardian-cli";
 export declare const GUARDIAN_NPX_SETUP_COMMAND = "npx @contextecf/guardian-cli@latest setup";
 export declare const GUARDIAN_FIRST_RUN_COMMAND = "guardian setup";
-export declare const GUARDIAN_OPEN_CONTROL_TOWER_COMMAND = "guardian launch";
+export declare const GUARDIAN_OPEN_CONTROL_TOWER_COMMAND = "guardian open";
+export declare const GUARDIAN_RELEASE_DISPATCH_WORKFLOW = "guardian-release-dispatch.yml";
+export declare const GUARDIAN_RELEASE_REPOSITORY = "Intelligent-Context-AI-Inc/ContextECF-GITHUB";
 export declare const GUARDIAN_CONTROL_TOWER_URL_ENV = "GUARDIAN_CONTROL_TOWER_URL";
 export declare const GUARDIAN_DEFAULT_CONTROL_TOWER_URL = "http://127.0.0.1:4317/control-tower";
 export declare const GUARDIAN_LOCAL_DATA_ENCRYPTION_KEY_ENV = "GUARDIAN_LOCAL_DATA_ENCRYPTION_KEY";
@@ -67,6 +70,7 @@ export interface GuardianDaemonHealthResult {
     statusCode?: number;
     service?: string;
     rawContentPersistence?: boolean;
+    version?: string;
     error?: string;
 }
 export interface GuardianDesktopActionExecutionRequest {
@@ -136,6 +140,173 @@ export interface GuardianReleaseEvidenceStatus {
     productionGateEvidence?: GuardianProductionGateEvidenceStatus;
     error?: string;
 }
+export interface GuardianReleaseDispatchCommandResult {
+    schema_version: 'contextecf/project-guardian-release-dispatch-command/v1';
+    cli_version: string;
+    workflow: typeof GUARDIAN_RELEASE_DISPATCH_WORKFLOW;
+    releaseVersion: string;
+    channels: string;
+    dryRun: boolean;
+    runDockerSmoke: boolean;
+    command: string;
+    requiredPublishCredentialName?: 'NPM_TOKEN';
+    provenance: 'github_actions_oidc_supported';
+    boundaries: string[];
+    tokenPrinted: false;
+    rawContentIncluded: false;
+}
+export interface GuardianReleaseHelpResult {
+    schema_version: 'contextecf/project-guardian-release-help/v1';
+    cli_version: string;
+    repository: typeof GUARDIAN_RELEASE_REPOSITORY;
+    status: 'release_owner_quickstart';
+    commands: {
+        checklist: string;
+        flow: string;
+        secrets: string;
+        dryRunDispatch: string;
+        publishDispatch: string;
+        verifyPublishedVersion: string;
+        pasteLocalSmoke: string;
+        browserStoreHandoff: string;
+        readiness: string;
+    };
+    suggestedOrder: string[];
+    boundaries: string[];
+    tokenPrinted: false;
+    rawContentIncluded: false;
+}
+export interface GuardianBrowserStoreHandoffCommandResult {
+    schema_version: 'contextecf/project-guardian-browser-store-handoff-command/v1';
+    cli_version: string;
+    status: 'chrome_distribution_proven_next_submission_pack_ready';
+    primaryStore: 'chrome_web_store';
+    productionGate: {
+        id: 'browser-store-distribution';
+        status: 'proven';
+        nextSubmissionRequiresFreshOfficialReviewEvidence: true;
+    };
+    commands: {
+        submissionPack: string;
+        preSubmissionSmoke: string;
+        preSubmissionReadiness: string;
+        reviewPreflightAfterApproval: string;
+        collectorAfterApproval: string;
+        finalGateValidation: string;
+    };
+    evidence: {
+        submissionPackDir: string;
+        closeoutChecklistPath: string;
+        preSubmissionChecklistPath: string;
+        readinessOutput: string;
+        reviewPreflightOutput: string;
+        productionGatePacket: string;
+    };
+    boundaries: string[];
+    tokenPrinted: false;
+    rawContentIncluded: false;
+}
+export interface GuardianReleaseSecretSetupResult {
+    schema_version: 'contextecf/project-guardian-release-secret-setup/v1';
+    cli_version: string;
+    repository: typeof GUARDIAN_RELEASE_REPOSITORY;
+    requiredForPublish: 'NPM_TOKEN';
+    githubActionsSecretUrl: string;
+    commands: {
+        setNpmToken: string;
+        verifyNpmTokenPresence: string;
+        dryRunDispatch: string;
+        publishDispatch: string;
+    };
+    boundaries: string[];
+    tokenPrinted: false;
+    rawContentIncluded: false;
+}
+export interface GuardianReleaseChecklistResult {
+    schema_version: 'contextecf/project-guardian-release-checklist/v1';
+    cli_version: string;
+    releaseVersion: string;
+    repository: typeof GUARDIAN_RELEASE_REPOSITORY;
+    status: 'preview_release_operator_ready_full_production_blocked';
+    operatorCommands: {
+        secretSetup: string;
+        dryRunDispatch: string;
+        publishDispatch: string;
+        browserStoreHandoff: string;
+        readiness: string;
+    };
+    requiredRepositoryCredentialName: 'NPM_TOKEN';
+    evidenceOutputs: string[];
+    notProvenProductionGates: Array<{
+        id: string;
+        label: string;
+        owner?: string;
+        releaseBoundary?: string;
+    }>;
+    boundaries: string[];
+    tokenPrinted: false;
+    rawContentIncluded: false;
+}
+export interface GuardianReleaseVerifyResult {
+    schema_version: 'contextecf/project-guardian-release-verify/v1';
+    cli_version: string;
+    releaseVersion: string;
+    repository: typeof GUARDIAN_RELEASE_REPOSITORY;
+    packageName: typeof GUARDIAN_NPM_PACKAGE_NAME;
+    registry: typeof GUARDIAN_NPM_REGISTRY;
+    status: 'post_release_verification_required';
+    commands: {
+        registryVersion: string;
+        publicInstall: string;
+        installedVersion: string;
+        setup: string;
+        launch: string;
+        status: string;
+        openControlTower: string;
+        copyPasteLocalSmoke: string;
+        publishStatusVerification: string;
+        finishLineStatus: string;
+    };
+    evidenceOutputs: string[];
+    boundaries: string[];
+    tokenPrinted: false;
+    rawContentIncluded: false;
+}
+export interface GuardianReleaseFlowResult {
+    schema_version: 'contextecf/project-guardian-release-flow/v1';
+    cli_version: string;
+    releaseVersion: string;
+    repository: typeof GUARDIAN_RELEASE_REPOSITORY;
+    status: 'release_owner_flow_ready_full_production_blocked';
+    steps: Array<{
+        id: string;
+        label: string;
+        command: string;
+        credentialRequired: boolean;
+    }>;
+    copyPasteLocalSmoke: string;
+    evidenceOutputs: string[];
+    notProvenProductionGates: Array<{
+        id: string;
+        label: string;
+        releaseBoundary?: string;
+    }>;
+    boundaries: string[];
+    tokenPrinted: false;
+    rawContentIncluded: false;
+}
+export interface GuardianReleasePasteResult {
+    schema_version: 'contextecf/project-guardian-release-paste/v1';
+    cli_version: string;
+    releaseVersion: string;
+    packageName: typeof GUARDIAN_NPM_PACKAGE_NAME;
+    registry: typeof GUARDIAN_NPM_REGISTRY;
+    command: string;
+    commands: string[];
+    boundaries: string[];
+    tokenPrinted: false;
+    rawContentIncluded: false;
+}
 declare const PROMPT_COACH_MODES: readonly ["off", "quiet", "balanced", "hands_on"];
 export type GuardianPromptCoachMode = (typeof PROMPT_COACH_MODES)[number];
 export declare const GUARDIAN_POSTURE_PROFILE_IDS: readonly ["calm", "balanced", "guided", "high_assurance", "autopilot_lite"];
@@ -369,6 +540,46 @@ export interface GuardianProductionReadinessStatus {
         productionGateEvidenceStatus: GuardianProductionGateEvidenceStatus['status'] | 'not_recorded';
         productionGateEvidencePath?: string;
     };
+    distribution: {
+        status: 'preview_install_ready' | 'setup_or_release_evidence_required';
+        oneLineInstallCommand: typeof GUARDIAN_GLOBAL_INSTALL_COMMAND;
+        oneLineTryCommand: typeof GUARDIAN_NPX_SETUP_COMMAND;
+        openControlTowerCommand: typeof GUARDIAN_OPEN_CONTROL_TOWER_COMMAND;
+        localUserCommands: {
+            setup: typeof GUARDIAN_FIRST_RUN_COMMAND;
+            launch: 'guardian launch';
+            open: 'guardian open';
+            status: 'guardian status';
+            readiness: 'guardian readiness';
+        };
+        aiToolIntegration: {
+            mcpInstallCommand: 'guardian mcp install --client=all --write';
+            browserSetupCommand: 'guardian extension open-setup';
+            nativeHostInstallCommand: 'guardian extension native-host install --extension-id=<browser-extension-id>';
+        };
+        browserStoreHandoff: {
+            status: 'operator_handoff_ready_not_submitted' | 'blocked_until_preview_ready';
+            submissionPackCommand: 'npm run guardian:browser-store:submission-pack';
+            closeoutChecklistPath: 'release/evidence/guardian-browser-store-submission-pack/browser-store-closeout-checklist.json';
+            productionGateStatus: 'not_proven';
+        };
+        enterpriseDeployment: {
+            status: 'managed_rollout_ready_for_customer_pack';
+            note: string;
+        };
+        releaseAutomation: {
+            workflow: typeof GUARDIAN_RELEASE_DISPATCH_WORKFLOW;
+            dryRunCommand: string;
+            publishCommand: string;
+            requiredPublishCredentialName: 'NPM_TOKEN';
+            channels: readonly ['all', 'npm', 'browser', 'evidence'];
+            defaultDockerSmoke: true;
+            provenance: 'github_actions_oidc_supported';
+            status: 'ready_for_dispatch_after_preview_evidence' | 'blocked_until_preview_release_evidence_passes';
+            boundaries: string[];
+        };
+        boundaries: string[];
+    };
     tokenPrinted: false;
     rawContentIncluded: false;
 }
@@ -520,4 +731,5 @@ export declare function executeGuardianDesktopActionPlan(home: string, profile:
 }>;
 export declare function buildGuardianReleaseEvidenceStatus(home: string): Promise<GuardianReleaseEvidenceStatus>;
 export declare function buildGuardianDoctorStatus(home: string, profile: GuardianProfile | undefined, env?: NodeJS.ProcessEnv | undefined): Promise<GuardianDoctorStatus>;
+export declare function isGuardianSupportedNodeVersion(nodeVersion: string): boolean;
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contextecf/guardian-cli",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "Project Guardian local-first Personal Context Fabric CLI",
   "type": "module",
   "license": "UNLICENSED",
@@ -53,7 +53,7 @@
     "@contextecf/personal-fabric-contracts": "*",
     "@contextecf/personal-fabric-runtime": "*",
     "@contextecf/personal-fabric-store": "*",
-    "esbuild": "^0.25.0",
+    "esbuild": "^0.28.1",
     "vitest": "^4.1.8"
   }
 }