@tiangong-ai/cli 0.0.35 → 0.0.37

package/dist/research/workspace/sanitization.js

@@ -50,17 +50,23 @@ function sanitizeUrls(value) {
         const source = trailing ? bounded.source.slice(0, -trailing.length) : bounded.source;
         try {
             const url = new URL(source);
+            let changed = false;
             if (url.username || url.password) {
                 url.username = "REDACTED";
                 url.password = "";
+                changed = true;
             }
             for (const key of [...url.searchParams.keys()]) {
-                if (SENSITIVE_QUERY_KEY.test(key))
+                if (SENSITIVE_QUERY_KEY.test(key)) {
                     url.searchParams.set(key, "[REDACTED]");
+                    changed = true;
+                }
             }
-            if (SENSITIVE_URL_FRAGMENT.test(url.hash))
+            if (SENSITIVE_URL_FRAGMENT.test(url.hash)) {
                 url.hash = "REDACTED";
-            return `${url.toString()}${trailing}${bounded.suffix}`;
+                changed = true;
+            }
+            return changed ? `${url.toString()}${trailing}${bounded.suffix}` : candidate;
         }
         catch {
             return candidate;

package/dist/research/workspace/sanitization.js.map

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

package/dist/research/workspace/scientific-design.d.ts

@@ -0,0 +1,359 @@
+export type ScientificStudyKind = "causal-empirical" | "observational-empirical" | "predictive-model" | "mechanism-model" | "cross-model-comparison" | "scenario-analysis" | "material-flow-accounting" | "systematic-synthesis" | "methods-data-resource";
+export type ScientificResultClass = "causal-estimate" | "observational-estimate" | "validated-forecast" | "model-output" | "scenario-output" | "accounting-output" | "systematic-synthesis" | "method-performance";
+export type EvidenceAcquisitionRouteClass = "broker-capability" | "native-discovery" | "open-access-download" | "authorized-browser" | "licensed-resource" | "owner-provided-resource" | "external-data-request" | "field-data-collection";
+export type EvidenceAcquisitionExecutor = "agent" | "user" | "external-party";
+export type EvidenceAccessMode = "open-public" | "owner-authorized" | "user-authorization-required" | "purchase-or-subscription" | "external-request";
+export interface ScientificDesignContract {
+    schemaVersion: 1;
+    projectId: string;
+    workingTitle: string;
+    identity: {
+        centralStudyKind: ScientificStudyKind;
+        contributionStatement: string;
+        components: Array<{
+            kind: ScientificStudyKind;
+            role: "central" | "supporting" | "contextual";
+            purpose: string;
+            bridgeEdgeIds: string[];
+        }>;
+        modelStructures: Array<{
+            id: string;
+            label: string;
+            family: string;
+            version: string;
+            equationSet: string;
+            coefficientSet: string;
+            implementationArtifactSha256: string;
+            implementationArtifactLocator: string;
+            implementationEntrypoint: string;
+            implementationStatus: "executable-frozen" | "pending-source-acquisition";
+            implementationFreezeBeforeGate: "research-design" | "evidence-construct" | "pilot-methods";
+            environmentLockSha256: string;
+            environmentLockLocator: string;
+            environmentLockStatus: "exact-frozen" | "pending-runtime-lock";
+            environmentLockFreezeBeforeGate: "research-design" | "evidence-construct" | "pilot-methods";
+            artifactHashBasis: "raw-file-bytes";
+            baselineRole: "candidate" | "reference" | "strongest-available";
+            baselineSelectionJustification: string;
+            sourceEvidenceRoleIds: string[];
+        }>;
+        allowedClaimVerbs: string[];
+        targetJournals: {
+            primary: string;
+            alternate: string;
+            fallback: string;
+            approvalStatus: "candidate-only" | "policy-approved";
+        };
+    };
+    policyRuleDispositions: Array<{
+        ruleId: string;
+        status: "satisfied-by-design" | "planned" | "scope-limited" | "incompatible";
+        dueGate: "research-design" | "evidence-construct" | "pilot-methods" | "publication-freeze";
+        rationale: string;
+        claimIds: string[];
+        evidenceRoleIds: string[];
+        validationPlanIds: string[];
+        knownGapIds: string[];
+        uncertaintyParameterIds: string[];
+        modelStructureIds: string[];
+    }>;
+    estimands: Array<{
+        id: string;
+        role: "central" | "supporting" | "contextual";
+        population: string;
+        analysisUnit: string;
+        exposure: string;
+        comparator: string;
+        outcome: string;
+        spatialScale: string;
+        timeHorizon: string;
+        resultClass: ScientificResultClass;
+    }>;
+    claims: Array<{
+        id: string;
+        role: "central" | "supporting" | "contextual";
+        statement: string;
+        resultClass: ScientificResultClass;
+        edgeIds: string[];
+        endpointIds: string[];
+        comparisonIds: string[];
+        estimandIds: string[];
+        quantityIds: string[];
+        evidenceRoleIds: string[];
+        hypothesisMode: "two-sided" | "directional" | "descriptive" | "not-applicable";
+        nullOutcomeStatement: string | null;
+    }>;
+    edges: Array<{
+        id: string;
+        role: "central" | "supporting" | "contextual";
+        fromConstruct: string;
+        toConstruct: string;
+        evidenceMode: "direct-observation" | "model-bridge" | "accounting-bridge" | "assumption-only";
+        requiredJoinKeys: string[];
+        temporalAlignment: string;
+        spatialAlignment: string;
+        fromModelStructureIds: string[];
+        toModelStructureIds: string[];
+        fromEndpointIds: string[];
+        toEndpointIds: string[];
+        operatorId: string;
+        operatorDefinition: string;
+        aggregationRule: string;
+        scaleReconciliation: string;
+        quantityIds: string[];
+        uncertaintyParameterIds: string[];
+        sameSectionRequired: boolean;
+        sameEventRequired: boolean;
+        status: "planned" | "constructible" | "blocked";
+        blockingReason: string | null;
+    }>;
+    endpoints: Array<{
+        id: string;
+        label: string;
+        physicalConstruct: string;
+        scale: string;
+        unit: string;
+        timeBasis: string;
+        modelStructureId: string | null;
+        truthRole: "field-observation" | "experimental-reference" | "engineering-model" | "proxy" | "scenario-output" | "accounting-output";
+    }>;
+    comparisons: Array<{
+        id: string;
+        leftEndpointId: string;
+        rightEndpointId: string;
+        operation: "error" | "accuracy" | "validation" | "agreement" | "discrepancy" | "ranking" | "qualitative-boundary";
+        axis: "same-endpoint-cross-model" | "model-to-observation" | "decision-consequence" | "qualitative-boundary";
+        quantityIds: string[];
+        thresholdIds: string[];
+        decisionRule: string;
+        reportingLevel: string;
+        truthEndpointId: string | null;
+    }>;
+    quantities: Array<{
+        id: string;
+        label: string;
+        quantityType: "share" | "material" | "rate" | "count" | "index" | "other";
+        unit: string;
+        numeratorType: string;
+        denominatorType: string;
+        denominatorDescription: string;
+        normalizationMode: "symmetric" | "directional-convention" | "not-applicable";
+        normalizationJustification: string;
+        valueMode: "signed" | "absolute" | "nonnegative" | "categorical";
+        uncertaintyParameterIds: string[];
+        spatialScope: string;
+        temporalScope: string;
+        allowedTerms: string[];
+        prohibitedTerms: string[];
+    }>;
+    validationPlans: Array<{
+        id: string;
+        claimIds: string[];
+        role: "internal-holdout" | "temporal-holdout" | "section-holdout" | "external-dgp" | "cross-model-reference" | "background-constraint" | "not-applicable";
+        parameterDatasetIds: string[];
+        comparisonDatasetIds: string[];
+        datasetRoles: Array<{
+            datasetId: string;
+            role: "parameter-source" | "endpoint-definition-source" | "non-independent-cross-check" | "independent-validation" | "background-context";
+            sharedUpstreamIds: string[];
+            justification: string;
+        }>;
+        factorIds: string[];
+        exposureIdentifierAvailable: boolean;
+        independentDataGeneratingProcess: boolean;
+        outcomeBlind: boolean;
+        originalUnitCount: number;
+        independentClusterCount: number;
+        effectiveIndependentUnits: number;
+        originalUnitDefinition: string;
+        independentClusterDefinition: string;
+        nestingRule: string;
+        reportingUnitDefinition: string;
+        clusterKeyIds: string[];
+        independenceJustification: string;
+        resamplingUnit: string;
+        resamplingIterations: number;
+        resamplingMethod: "exact-enumeration" | "cluster-bootstrap" | "none";
+        resamplingStateSpaceSize: number;
+        reportingPrecision: string;
+        minimumDetectableDifference: string | null;
+        independentValidation: {
+            status: "available" | "planned" | "unavailable-scope-bounded" | "not-required";
+            gapId: string | null;
+            justification: string;
+        };
+        status: "planned" | "feasible" | "impossible";
+        blockingReason: string | null;
+    }>;
+    thresholds: Array<{
+        id: string;
+        claimId: string;
+        quantityId: string;
+        type: "analytic" | "scenario" | "estimated" | "policy-trigger";
+        reportedAs: "analytic-threshold" | "scenario-threshold" | "estimated-threshold" | "policy-trigger";
+        criterion: string;
+        criterionQuantityIds: string[];
+        numericValue: number | null;
+        unit: string;
+        direction: "above" | "below" | "outside" | "equal" | "categorical";
+        basis: "reporting-convention" | "domain-standard" | "decision-consequence" | "policy";
+        basisJustification: string;
+        stabilityMode: "sign" | "classification" | "range" | "none";
+        stabilityQuantityId: string | null;
+        stabilityRule: string;
+        sensitivityReportingRule: string;
+        assumptionIds: string[];
+        sensitivityParameterIds: string[];
+    }>;
+    evidenceRoles: Array<{
+        id: string;
+        role: "central-model-source" | "central-data-documentation" | "closest-prior-work" | "counterevidence" | "method-identification" | "material-conversion" | "overlay-rule" | "cross-model-validation" | "pavement-context" | "limitation-boundary" | "target-journal-recent-work" | "background";
+        claimIds: string[];
+        coverageDimensionIds: string[];
+        sourceTypeRequirements: string[];
+        peerReviewedRequired: boolean;
+        required: boolean;
+        minimumFullText: number;
+        minimumIndependentSources: number;
+        minimumDatedSources: number;
+    }>;
+    acquisitionPlan: {
+        routes: Array<{
+            id: string;
+            evidenceRoleIds: string[];
+            routeClass: EvidenceAcquisitionRouteClass;
+            executor: EvidenceAcquisitionExecutor;
+            required: boolean;
+            capabilityId: string | null;
+            activityKind: "web-search" | "database-search" | "browser-navigation" | "download" | "file-inspection" | null;
+            activityChannel: string | null;
+            downloadBackends: Array<"native-browser" | "chrome" | "cloakbrowser" | "skill-adapter" | "direct-http">;
+            accessMode: EvidenceAccessMode;
+            rationale: string;
+        }>;
+        stopPolicy: {
+            allAgentRoutesExhaustedBeforeHandoff: boolean;
+            unresolvedRequiredEvidenceRoleBlocksDownstream: boolean;
+            prohibitUnreviewedSubstitution: boolean;
+        };
+    };
+    knownGaps: Array<{
+        id: string;
+        description: string;
+        sourceProjectId: string | null;
+        sourceArtifacts: Array<{
+            sha256: string;
+            objectLocator: string;
+            hashBasis: "raw-file-bytes";
+            kind: "scientific-review-packet" | "scientific-review" | "evidence-snapshot" | "publication-assessment" | "owner-attestation";
+        }>;
+        lineageStatus: "verified" | "owner-attested" | "unverified";
+        disposition: "unresolved" | "closed" | "scope-narrowed" | "user-handoff" | "external-handoff";
+        evidenceRefs: Array<{
+            kind: "claim" | "quantity" | "validation-plan" | "edge" | "evidence-role";
+            id: string;
+        }>;
+    }>;
+    uncertaintyParameters: Array<{
+        id: string;
+        label: string;
+        distributionOrRange: string;
+        states: Array<{
+            id: string;
+            label: string;
+            value: string;
+            unit: string;
+        }>;
+        stateValueType: "numeric" | "categorical";
+        stateValueStatus: "frozen" | "pending-source-acquisition";
+        freezeBeforeGate: "research-design" | "evidence-construct" | "pilot-methods";
+        factorIds: string[];
+        applicationPoint: string;
+        compositionRule: string;
+        preservesFactorLevelIdentity: boolean;
+        sourceEvidenceRoleIds: string[];
+        quantityIds: string[];
+    }>;
+    uncertaintyGroups: Array<{
+        id: string;
+        parameterIds: string[];
+        combinationMode: "one-at-a-time" | "full-factorial" | "explicit-joint-states";
+        jointStateIds: string[];
+        jointStateBindings: Array<{
+            jointStateId: string;
+            parameterStateIds: string[];
+        }>;
+        applicationRule: string;
+        sharedAcrossModelStructureIds: string[];
+    }>;
+    factors: Array<{
+        id: string;
+        label: string;
+        role: "exposure" | "blocking" | "scenario";
+        observationalStatus: "observed" | "modeled-only" | "externally-defined";
+        applicabilityBoundary: string;
+        evidenceRoleIds: string[];
+        levels: Array<{
+            id: string;
+            label: string;
+            definition: string;
+            attributes: Array<{
+                id: string;
+                label: string;
+                value: string;
+                unit: string;
+            }>;
+        }>;
+    }>;
+    baselinePlan: {
+        sameInputInformation: boolean;
+        comparableCalibrationBudget: boolean;
+        sameEndpoint: boolean;
+        frozenBeforeAnalysis: boolean;
+        decisionLossMetrics: Array<{
+            id: string;
+            label: string;
+            comparisonIds: string[];
+            quantityIds: string[];
+            decisionRule: string;
+            reportingLevel: string;
+        }>;
+    };
+    contextPlan: {
+        maxEstimatedTokens: number;
+        estimatedTokens: number;
+        claimCriticalCapsuleIds: string[];
+        backgroundIndexOnly: boolean;
+        centralEvidenceFits: boolean;
+    };
+}
+export interface ScientificDesignIssue {
+    code: string;
+    severity: "blocking" | "major" | "minor";
+    message: string;
+    objectIds: string[];
+}
+export interface ScientificDesignEvaluation {
+    schemaVersion: 1;
+    projectId: string;
+    centralStudyKind: ScientificStudyKind;
+    readyForDesignReview: boolean;
+    issues: ScientificDesignIssue[];
+    issueCodes: string[];
+    effectiveIndependentUnits: number;
+    requiredEvidenceRoles: number;
+}
+export interface VerifiedScientificDesign {
+    schemaVersion: 1;
+    contract: ScientificDesignContract;
+    sha256: string;
+    bytes: number;
+}
+export declare function scientificDesignSchema(): Record<string, unknown>;
+export declare function parseScientificDesign(value: unknown): ScientificDesignContract;
+export declare function readAndVerifyScientificDesign(path: string, expectedProjectId?: string): Promise<VerifiedScientificDesign>;
+export declare function evaluateScientificDesign(design: ScientificDesignContract): ScientificDesignEvaluation;
+export declare function scientificDesignPolicyGaps(design: ScientificDesignContract, policy: {
+    resolvedRules: string[];
+    targetJournal: string | null;
+}): string[];