arkgate 4.3.0 → 4.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (61) hide show
  1. package/CHANGELOG.md +81 -10
  2. package/README.md +11 -7
  3. package/bin/ark-check-runtime.mjs +50 -14
  4. package/bin/ark-layer-match.mjs +25 -12
  5. package/bin/lib/agent-projection.mjs +1 -1
  6. package/bin/lib/analysis-engine.mjs +5 -5
  7. package/bin/lib/ci-and-commands.mjs +11 -5
  8. package/bin/lib/doctor-plan.mjs +25 -0
  9. package/bin/lib/html-report-advisories.mjs +33 -0
  10. package/bin/lib/html-report-depth.mjs +24 -0
  11. package/bin/lib/html-report.mjs +8 -1
  12. package/bin/lib/improvement-compass-doctor.mjs +106 -0
  13. package/bin/lib/improvement-compass-map.mjs +507 -0
  14. package/bin/lib/improvement-compass-types.mjs +85 -0
  15. package/bin/lib/improvement-compass.mjs +79 -0
  16. package/bin/lib/managed-upgrade-honesty.mjs +201 -0
  17. package/bin/lib/managed-upgrade.mjs +37 -4
  18. package/bin/lib/status-command.mjs +127 -2
  19. package/bin/lib/status-manifest.mjs +187 -1
  20. package/dist/eslint/index.cjs +2 -2
  21. package/dist/eslint/index.js +2 -2
  22. package/dist/index.cjs +35 -35
  23. package/dist/index.d.ts +267 -5
  24. package/dist/index.js +35 -35
  25. package/docs/README.md +7 -6
  26. package/docs/agent-guide.md +50 -7
  27. package/docs/develop.md +9 -4
  28. package/docs/diagnostics.md +1 -1
  29. package/docs/package-surface.md +38 -34
  30. package/docs/product-voice.md +30 -1
  31. package/docs/use.md +67 -1
  32. package/package.json +1 -1
  33. package/schemas/ark.status-manifest.schema.json +53 -0
  34. package/server.json +2 -2
  35. package/templates/agent-skills/README.md +2 -2
  36. package/templates/agent-skills/ark-adopt/SKILL.md +20 -0
  37. package/templates/agent-skills/ark-architect/SKILL.md +21 -1
  38. package/templates/agent-skills/ark-autopilot/SKILL.md +25 -5
  39. package/templates/agent-skills/ark-contract/SKILL.md +20 -0
  40. package/templates/agent-skills/ark-coverage/SKILL.md +20 -0
  41. package/templates/agent-skills/ark-explain/SKILL.md +20 -0
  42. package/templates/agent-skills/ark-explore/SKILL.md +23 -3
  43. package/templates/agent-skills/ark-fix/SKILL.md +22 -2
  44. package/templates/agent-skills/ark-loop/SKILL.md +22 -2
  45. package/templates/agent-skills/ark-place/SKILL.md +20 -0
  46. package/templates/agent-skills/ark-runtime/SKILL.md +7 -0
  47. package/templates/agent-skills/ark-think/SKILL.md +20 -0
  48. package/templates/agent-skills/ark-upgrade/SKILL.md +20 -0
  49. package/templates/skills/ark-adopt.md +20 -0
  50. package/templates/skills/ark-architect.md +21 -1
  51. package/templates/skills/ark-autopilot.md +25 -5
  52. package/templates/skills/ark-contract.md +20 -0
  53. package/templates/skills/ark-coverage.md +20 -0
  54. package/templates/skills/ark-explain.md +20 -0
  55. package/templates/skills/ark-explore.md +23 -3
  56. package/templates/skills/ark-fix.md +22 -2
  57. package/templates/skills/ark-loop.md +22 -2
  58. package/templates/skills/ark-place.md +20 -0
  59. package/templates/skills/ark-runtime.md +7 -0
  60. package/templates/skills/ark-think.md +20 -0
  61. package/templates/skills/ark-upgrade.md +20 -0
package/dist/index.d.ts CHANGED
@@ -244,7 +244,7 @@ declare function loadArkConfigContract(input: unknown, source?: string): ArkConf
244
244
  declare function parseArkConfigJson(json: string, source?: string): ArkConfigLoadResult;
245
245
 
246
246
  /** ArkGate library version — single source of truth. */
247
- declare const version = "4.3.0";
247
+ declare const version = "4.5.0";
248
248
 
249
249
  /** Versioned public result contract shared by every ArkGate enforcement adapter. */
250
250
  /**
@@ -2881,17 +2881,18 @@ declare function catalogFixForRuleId(ruleId: string | null | undefined): string
2881
2881
  declare function catalogWhyForRuleId(ruleId: string | null | undefined): string | undefined;
2882
2882
 
2883
2883
  /**
2884
- * Public status manifest (ACS03).
2884
+ * Public status manifest (ACS03 + DF02 honesty).
2885
2885
  *
2886
2886
  * One machine-readable session/project snapshot for agents: project identity
2887
2887
  * binding, honest write-path activation, last-check summary, ArkRules residual
2888
- * counts, and a primary next action. Binary facts only never a numeric score,
2889
- * never an LLM verdict, never a prompt.
2888
+ * counts, a primary next action, and an honest improvement-compass residual map.
2889
+ * Binary facts only — never a numeric score, never an LLM verdict, never a prompt.
2890
2890
  *
2891
2891
  * **Canonical** for `ark status --json`, MCP `ark_status`, and schema export.
2892
2892
  * Tooling gathers filesystem evidence; this module only assembles pure facts.
2893
2893
  *
2894
2894
  * @see docs/plans/agent-contract-surface-4.3/README.md
2895
+ * @see docs/plans/domain-fitness-session-truth/README.md (DF02)
2895
2896
  */
2896
2897
 
2897
2898
  declare const ARK_STATUS_MANIFEST_SCHEMA_VERSION: "1.0";
@@ -2900,6 +2901,24 @@ declare const ARK_STATUS_MANIFEST_SCHEMA_URL = "https://unpkg.com/arkgate@4/sche
2900
2901
  type StatusWritePathClass = 'hard' | 'advisory' | 'unavailable';
2901
2902
  /** Last architecture check verdict when evidence exists. */
2902
2903
  type StatusCheckVerdict = 'pass' | 'fail' | 'incomplete' | null;
2904
+ /**
2905
+ * Honesty mode for status improvementCompass (DF02).
2906
+ * - full: residual projected from doctor-equivalent facts (residual ⊆ doctor)
2907
+ * - subset: incomplete facts; residual may omit doctor residual; never invent green
2908
+ * - unavailable: no usable facts; empty residual + reason (never silent ok)
2909
+ */
2910
+ declare const STATUS_COMPASS_MODES: readonly ["full", "subset", "unavailable"];
2911
+ type StatusCompassMode = (typeof STATUS_COMPASS_MODES)[number];
2912
+ /** Provenance for status compass residual (same-tree intent). */
2913
+ declare const STATUS_COMPASS_FACTS_SOURCES: readonly ["doctor-facts", "report-snapshot", "none"];
2914
+ type StatusCompassFactsSource = (typeof STATUS_COMPASS_FACTS_SOURCES)[number];
2915
+ /** Stable reason codes when mode is not full. */
2916
+ declare const STATUS_COMPASS_REASON_CODES: {
2917
+ readonly FACTS_UNAVAILABLE: "FACTS_UNAVAILABLE";
2918
+ readonly FACTS_PARTIAL: "FACTS_PARTIAL";
2919
+ readonly NO_SESSION_SNAPSHOT: "NO_SESSION_SNAPSHOT";
2920
+ };
2921
+ type StatusCompassReasonCode = (typeof STATUS_COMPASS_REASON_CODES)[keyof typeof STATUS_COMPASS_REASON_CODES];
2903
2922
  type StatusProjectIdentitySlice = {
2904
2923
  projectId: string | null;
2905
2924
  resolvedRoot: string;
@@ -2931,6 +2950,29 @@ type StatusNextAction = {
2931
2950
  id: string;
2932
2951
  summary: string;
2933
2952
  };
2953
+ /**
2954
+ * Optional thin improvement-compass projection on status (additive; DF02).
2955
+ * Full lenses live on doctor JSON; status carries residual **ids** + honesty mode.
2956
+ * Always notAScore; never a gate input (does not flip valid / strict-merge / goal.met).
2957
+ */
2958
+ type StatusImprovementCompassSlice = {
2959
+ schemaVersion: '1.0';
2960
+ notAScore: true;
2961
+ /** Explicit honesty: full | subset | unavailable */
2962
+ mode: StatusCompassMode;
2963
+ /**
2964
+ * Residual lens ids only. Empty when mode is unavailable (not a green claim).
2965
+ * When mode is full, ids are a subset of doctor residual for the same facts.
2966
+ */
2967
+ topResidual: string[];
2968
+ /** Present when mode is subset or unavailable. */
2969
+ reasonCode?: string;
2970
+ reason?: string;
2971
+ /** Where residual evidence came from. */
2972
+ factsSource?: StatusCompassFactsSource;
2973
+ /** Optional contract content hash for same-tree provenance. */
2974
+ contractHash?: string;
2975
+ };
2934
2976
  type StatusManifest = {
2935
2977
  schemaVersion: typeof ARK_STATUS_MANIFEST_SCHEMA_VERSION;
2936
2978
  arkgateVersion: string;
@@ -2939,6 +2981,11 @@ type StatusManifest = {
2939
2981
  lastCheck: StatusLastCheckSlice;
2940
2982
  rules: StatusRulesSlice;
2941
2983
  nextAction: StatusNextAction;
2984
+ /**
2985
+ * Improvement compass residual map with honesty mode (DF02).
2986
+ * Tooling should always supply a projection (including mode=unavailable).
2987
+ */
2988
+ improvementCompass?: StatusImprovementCompassSlice;
2942
2989
  };
2943
2990
  /**
2944
2991
  * Pure facts supplied by Tooling after path canonicalization and I/O.
@@ -2982,6 +3029,11 @@ type StatusManifestFacts = {
2982
3029
  rulesFrozenResidual?: number | null;
2983
3030
  /** Optional override when Tooling already computed productHonesty next action. */
2984
3031
  nextActionOverride?: StatusNextAction | null;
3032
+ /**
3033
+ * Improvement compass residual slice (notAScore) with honesty mode.
3034
+ * Prefer projectStatusImprovementCompass() before passing facts.
3035
+ */
3036
+ improvementCompass?: StatusImprovementCompassSlice | null;
2985
3037
  };
2986
3038
  /**
2987
3039
  * Evaluate project binding for status without filesystem.
@@ -3010,6 +3062,44 @@ declare function defaultHonestLabel(writePath: StatusWritePathClass, host: strin
3010
3062
  */
3011
3063
  declare function resolveStatusNextAction(facts: StatusManifestFacts, binding: ProjectBinding, activation: StatusActivationSlice, lastCheck: StatusLastCheckSlice, rules: StatusRulesSlice): StatusNextAction;
3012
3064
  declare function buildStatusManifest(facts: StatusManifestFacts): StatusManifest;
3065
+ /**
3066
+ * Project a thin status improvementCompass with explicit honesty mode (DF02).
3067
+ *
3068
+ * Rules:
3069
+ * - always notAScore: true
3070
+ * - mode full | subset | unavailable (invalid mode → unavailable)
3071
+ * - unavailable: topResidual forced empty (never invent residual or silent green)
3072
+ * - full/subset: residual ids from input only (never fabricate ok lenses)
3073
+ * - never carries valid / goal.met / score fields
3074
+ */
3075
+ declare function projectStatusImprovementCompass(input: {
3076
+ mode: StatusCompassMode | string;
3077
+ topResidual?: readonly string[] | null;
3078
+ reasonCode?: string | null;
3079
+ reason?: string | null;
3080
+ factsSource?: StatusCompassFactsSource | string | null;
3081
+ contractHash?: string | null;
3082
+ }): StatusImprovementCompassSlice;
3083
+ /**
3084
+ * Unavailable compass when Tooling has no doctor/report residual facts.
3085
+ * Empty residual + mode label — never a green / ok claim.
3086
+ */
3087
+ declare function unavailableStatusImprovementCompass(input?: {
3088
+ reasonCode?: string | null;
3089
+ reason?: string | null;
3090
+ contractHash?: string | null;
3091
+ }): StatusImprovementCompassSlice;
3092
+ /**
3093
+ * Normalize an incoming status compass slice (Tooling pass-through / snapshot).
3094
+ * Rejects score-like shapes; coerces missing mode to subset (never silent full).
3095
+ * Unavailable always clears residual.
3096
+ */
3097
+ declare function normalizeStatusImprovementCompass(value: StatusImprovementCompassSlice | null | undefined | Record<string, unknown>): StatusImprovementCompassSlice | null;
3098
+ /**
3099
+ * Residual-id subset check for status ⊆ doctor parity fixtures (DF02).
3100
+ * Returns true when every status residual id appears in doctor residual ids.
3101
+ */
3102
+ declare function statusCompassResidualIsSubsetOfDoctor(statusResidual: readonly string[] | null | undefined, doctorResidual: readonly string[] | null | undefined): boolean;
3013
3103
  /** JSON Schema for the public status manifest (package export + agents). */
3014
3104
  declare const ARK_STATUS_MANIFEST_SCHEMA: {
3015
3105
  readonly $schema: "https://json-schema.org/draft/2020-12/schema";
@@ -3176,9 +3266,181 @@ declare const ARK_STATUS_MANIFEST_SCHEMA: {
3176
3266
  };
3177
3267
  };
3178
3268
  };
3269
+ readonly improvementCompass: {
3270
+ readonly type: "object";
3271
+ readonly description: "Thin improvement-compass residual ids with honesty mode (notAScore). full | subset | unavailable. Never a gate input; full lenses on doctor JSON. When full, residual ids ⊆ doctor residual for the same facts. unavailable never invents green residual.";
3272
+ readonly additionalProperties: false;
3273
+ readonly required: readonly ["schemaVersion", "notAScore", "mode", "topResidual"];
3274
+ readonly properties: {
3275
+ readonly schemaVersion: {
3276
+ readonly const: "1.0";
3277
+ };
3278
+ readonly notAScore: {
3279
+ readonly const: true;
3280
+ };
3281
+ readonly mode: {
3282
+ readonly enum: readonly ["full", "subset", "unavailable"];
3283
+ };
3284
+ readonly topResidual: {
3285
+ readonly type: "array";
3286
+ readonly items: {
3287
+ readonly type: "string";
3288
+ readonly minLength: 1;
3289
+ };
3290
+ readonly maxItems: 15;
3291
+ };
3292
+ readonly reasonCode: {
3293
+ readonly type: "string";
3294
+ readonly minLength: 1;
3295
+ };
3296
+ readonly reason: {
3297
+ readonly type: "string";
3298
+ readonly minLength: 1;
3299
+ };
3300
+ readonly factsSource: {
3301
+ readonly enum: readonly ["doctor-facts", "report-snapshot", "none"];
3302
+ };
3303
+ readonly contractHash: {
3304
+ readonly type: "string";
3305
+ readonly minLength: 1;
3306
+ };
3307
+ };
3308
+ };
3179
3309
  };
3180
3310
  };
3181
3311
 
3312
+ /**
3313
+ * Improvement compass — closed types, constants, and labels (Domain pure).
3314
+ *
3315
+ * Split from improvementCompass.ts (DF03): contracts stay small and import-free
3316
+ * of mapping logic so CLI gen and unit tests share one vocabulary.
3317
+ *
3318
+ * Pure Domain: no fs, fetch, Date.now, process.
3319
+ */
3320
+ declare const ARK_IMPROVEMENT_COMPASS_SCHEMA_VERSION: "1.0";
3321
+ /** Closed 15 lens ids (stable order for projection). */
3322
+ declare const IMPROVEMENT_LENS_IDS: readonly ["soc", "cohesion", "coupling", "srp", "dip", "ocp", "encapsulation", "modularity", "scalability", "resilience", "security", "maintainability", "testability", "domain", "stack"];
3323
+ type ImprovementLensId = (typeof IMPROVEMENT_LENS_IDS)[number];
3324
+ type ImprovementLensStatus = 'ok' | 'residual' | 'not-instrumented' | 'out-of-scope';
3325
+ type ImprovementCompassEvidence = {
3326
+ source: string;
3327
+ ref: string;
3328
+ detail?: string;
3329
+ };
3330
+ type ImprovementCompassNextAction = {
3331
+ kind: string;
3332
+ ref: string;
3333
+ summary: string;
3334
+ };
3335
+ type ImprovementLens = {
3336
+ id: ImprovementLensId;
3337
+ status: ImprovementLensStatus;
3338
+ summary: string;
3339
+ evidence: ImprovementCompassEvidence[];
3340
+ nextAction?: ImprovementCompassNextAction;
3341
+ };
3342
+ type ImprovementCompass = {
3343
+ schemaVersion: typeof ARK_IMPROVEMENT_COMPASS_SCHEMA_VERSION;
3344
+ notAScore: true;
3345
+ lenses: ImprovementLens[];
3346
+ topResidual: ImprovementLensId[];
3347
+ };
3348
+ /** Cap for topResidual — short, agent-legible list (not a ranking score). */
3349
+ declare const IMPROVEMENT_COMPASS_TOP_RESIDUAL_CAP = 5;
3350
+ /** Locked out-of-scope — never become residual from missing sensors. */
3351
+ declare const IMPROVEMENT_COMPASS_OUT_OF_SCOPE_LENSES: readonly ["scalability", "resilience", "security"];
3352
+ type ImprovementCompassSmellFact = {
3353
+ /** Stable smell id (designSmells) or smellId alias. */
3354
+ id?: string;
3355
+ smellId?: string;
3356
+ message?: string;
3357
+ outcome?: string;
3358
+ evidence?: readonly string[];
3359
+ };
3360
+ type ImprovementCompassViolationFact = {
3361
+ ruleId?: string;
3362
+ code?: string;
3363
+ message?: string;
3364
+ fromLayer?: string;
3365
+ toLayer?: string;
3366
+ file?: string;
3367
+ /** When false, type-only placement debt — not runtime coupling (product voice). */
3368
+ failsStrict?: boolean;
3369
+ /** Alias for non-blocking type-only edges (mirrors doctor violation shape). */
3370
+ typeOnly?: boolean;
3371
+ };
3372
+ /**
3373
+ * Pure facts supplied by Tooling/doctor after I/O.
3374
+ * Domain never opens files or clocks time.
3375
+ */
3376
+ type ImprovementCompassFacts = {
3377
+ designSmells?: readonly ImprovementCompassSmellFact[];
3378
+ violations?: readonly ImprovementCompassViolationFact[];
3379
+ /** Detected import cycles (count). */
3380
+ cycleCount?: number;
3381
+ /** Peer-isolation residual findings (count) or true when any. */
3382
+ peerIsolationCount?: number | boolean;
3383
+ /** physicalCohesion findings length. */
3384
+ physicalCohesionFindingCount?: number;
3385
+ /** Whether ArkRules map is loaded on the contract. */
3386
+ arkRulesLoaded?: boolean;
3387
+ /** Open structure/invariant residual from ArkRules plane. */
3388
+ arkRulesStructureResidual?: number;
3389
+ /** designFitness.designWeak */
3390
+ designWeak?: boolean;
3391
+ baselineExists?: boolean;
3392
+ baselineStale?: number | null;
3393
+ frozenResidual?: number | null;
3394
+ dirtyBaselineRisk?: boolean;
3395
+ /** Pure / capability / forbidden residual counts. */
3396
+ pureOrCapabilityResidual?: number;
3397
+ forbiddenGlobalResidual?: number;
3398
+ /** Ungoverned directory suggestions / empty layers (modularity/placement). */
3399
+ ungovernedDirCount?: number;
3400
+ emptyLayerCount?: number;
3401
+ goldenPatternPresent?: boolean;
3402
+ /**
3403
+ * Host/language stack. TypeScript is partially instrumented (host/TS/Ark
3404
+ * idioms only). Unknown or non-TS stays not-instrumented / out-of-scope.
3405
+ */
3406
+ stackKind?: 'typescript' | 'unknown' | null;
3407
+ };
3408
+
3409
+ /**
3410
+ * Improvement compass (product 4.4.0) — pure Domain projection facade.
3411
+ *
3412
+ * Closed set of architecture **lenses** projected from existing doctor-side
3413
+ * evidence. Always `notAScore: true`. Never a gate input: residual lenses must
3414
+ * not flip `valid`, strict-merge exit, or `goal.met`.
3415
+ *
3416
+ * Out-of-scope lenses (`scalability`, `resilience`, `security`) are locked —
3417
+ * missing SAST/APM/chaos never invents residual.
3418
+ *
3419
+ * DF03 split: types → improvementCompassTypes.ts; fact mappers →
3420
+ * improvementCompassMap.ts; this module owns build + doctor formatters and
3421
+ * re-exports the public Domain surface.
3422
+ *
3423
+ * Pure Domain: no fs, fetch, Date.now, process — inject facts as input.
3424
+ */
3425
+
3426
+ /**
3427
+ * Build a deterministic improvement compass from supplied doctor-side facts.
3428
+ * Always returns all 15 lenses; always `notAScore: true`.
3429
+ */
3430
+ declare function buildImprovementCompass(facts?: ImprovementCompassFacts): ImprovementCompass;
3431
+ /**
3432
+ * Plain residual lens names for human doctor / compact router (never a score).
3433
+ */
3434
+ declare function formatImprovementCompassResidualLabels(compass: ImprovementCompass): string[];
3435
+ /**
3436
+ * Primary next action from the first residual lens that carries one.
3437
+ */
3438
+ declare function primaryImprovementCompassNextAction(compass: ImprovementCompass): ImprovementCompassNextAction | null;
3439
+ /**
3440
+ * Human doctor lines (no score bar). Caller prefixes section header.
3441
+ */
3442
+ declare function formatImprovementCompassDoctorLines(compass: ImprovementCompass): string[];
3443
+
3182
3444
  /**
3183
3445
  * Version-matched agent contract projection (ACS04).
3184
3446
  *
@@ -3455,4 +3717,4 @@ declare function agentSkillPackageFileRelativePath(skillName: string): string;
3455
3717
  */
3456
3718
  declare function flatSkillTemplateFileRelativePath(skillName: string): string;
3457
3719
 
3458
- export { ADAPTER_DIAGNOSTIC_DOCS_RELATIVE_PATH, AGENT_PROJECTION_BEGIN_MARKER, AGENT_PROJECTION_END_MARKER, AGENT_PROJECTION_ENFORCEMENT_SURFACES, AGENT_PROJECTION_NON_ENFORCEMENT_LABEL, AGENT_SKILLS_PACKAGE_RELATIVE_ROOT, AGENT_SKILL_ENTRY_FILENAME, type AICodeGate, type AICodeGateContext, type AICodeGateOptions, type AICodeGateResult, type AICodeGateViolation, type AIGateExtension, ANALYSIS_IR_SCHEMA_VERSION, ARK_AGENT_PROJECTION_SCHEMA_VERSION, ARK_AGENT_SKILLS_PACKAGE_SCHEMA_VERSION, ARK_ANALYSIS_RESULT_SCHEMA, ARK_ANALYSIS_RESULT_SCHEMA_VERSION, ARK_CONFIG_SCHEMA, ARK_CONFIG_SCHEMA_VERSION, ARK_DESIGN_DELTA_SCHEMA_VERSION, ARK_ENFORCEMENT_STATE_SCHEMA_VERSION, ARK_PROJECT_IDENTITY_SCHEMA, ARK_PROJECT_IDENTITY_SCHEMA_URL, ARK_PROJECT_IDENTITY_SCHEMA_VERSION, ARK_RULES_SCHEMA, ARK_RULES_SCHEMA_VERSION, ARK_RULE_SENSORS, ARK_SKILL_NAMES, ARK_SKILL_NAME_COUNT, ARK_STATUS_MANIFEST_SCHEMA, ARK_STATUS_MANIFEST_SCHEMA_URL, ARK_STATUS_MANIFEST_SCHEMA_VERSION, type AdapterCompletenessReason, type AdapterDiagnostic, type AdapterResult, type AdapterSeverity, type AdapterViolationInput, type AgentProjectionCatalogEntry, type AgentProjectionFacts, type AgentProjectionLayerSummary, type AgentProjectionMergeAction, type AgentProjectionMergeResult, type AgentProjectionMeta, type AgentProjectionProfile, type AgentSkillPackageEntry, type AgentSkillValidationIssue, type AnalysisCapabilityUse, type AnalysisCompilerOptions, type AnalysisCompleteness, type AnalysisContract, type AnalysisEvidence, type AnalysisFile, type AnalysisFileChange, type AnalysisFileInput, type AnalysisImportEdge, type AnalysisIr, type AnalysisMode, type AnalysisResult, type AnalysisViolation, type AnalyzeArchitectureConvergenceInput, type AnalyzeChangeInput, type AnalyzePolicyDeltaInput, type AnalyzeProjectInput, type AnalyzeResolvedProjectInput, type ArchitectureActualChange, type ArchitectureChangeMap, type ArchitectureChangeMapContract, type ArchitectureChangeMapDependency, type ArchitectureChangeMapFile, type ArchitectureChangeOperation, type ArchitectureConvergenceClassification, type ArchitectureConvergenceFinding, type ArchitectureConvergenceResult, type ArchitectureDependency, type ArchitectureEngineEdge, type ArchitectureEngineResult, type ArchitectureEngineViolation, type ArchitectureLayer, type ArchitectureLayerConfig, type ArchitectureProfile, type ArchitectureRule, type ArkCheckConfig, ArkConfig, ArkConfigLoadResult, type ArkDesignDeltaResult, type ArkEnforcementHost, type ArkEnforcementState, type ArkRuleSensorViolation, type ArkRulesFile, type ArkSkillName, type ChangePreflightResult, type ClassShapeFact, type CollectAnalysisConfigWarningsInput, type CreateArchitectureProfileFromArkConfigOptions, type CreateArchitectureProfileOptions, type CreateElevenLayerArkConfigOptions, DEFAULT_AGENT_PROJECTION_RULE_IDS, DIAGNOSTIC_CATALOG, DIAGNOSTIC_CATALOG_SCHEMA_VERSION, DIAGNOSTIC_DOCS_RELATIVE_PATH, DIAGNOSTIC_RULE_IDS, type DesignDeltaChange, type DesignDeltaIdentity, type DesignSmellEvidence, type DesignSmellFinding, type DesignSmellId, type DiagnosticCatalogEntry, type DiagnosticCategory, type EffectiveArkRules, type EffectiveContract, EffectiveContractError, type EffectiveContractWarning, type EnforcementBoundaryState, type EnforcementEvidence, type EnforcementEvidenceField, type EnforcementVerification, type EvaluateArchitectureGraphInput, FLAT_SKILL_TEMPLATES_RELATIVE_ROOT, type ForbiddenCapabilityUse, type InvariantCoverageEvidence, POLICY_DELTA_SCHEMA_VERSION, PROJECT_BINDING_SCHEMA, PROJECT_EXPECTATION_SCHEMA, type ParseSkillDocumentResult, type ParsedSkillFrontmatter, type PolicyDelta, type PolicyDeltaAcknowledgement, type PolicyDeltaAnalysis, type PolicyDeltaClassification, type PolicyDeltaFinding, type PreflightResolvedChangeInput, type PreparedChangeFile, type ProjectBinding, type ProjectExpectation, type ProjectIdentity, RESOLVED_CANDIDATE_FACTS_SCHEMA, RESOLVED_CANDIDATE_FACTS_SCHEMA_VERSION, type ResolvedAmbientFact, type ResolvedAnalysisFile, type ResolvedAnalysisIr, type ResolvedAnalysisResult, type ResolvedCandidateFacts, type ResolvedCandidateFactsInput, type ResolvedCapability, type ResolvedCapabilityFact, type ResolvedChangePreflightResult, type ResolvedDependencyFact, type ResolvedDependencyKind, type ResolvedDependencyState, type ResolvedFactsCompleteness, type ResolvedFactsReason, type ResolvedFileFact, type ResolvedIntentReferenceFact, type ResolvedPublishFact, type ResolvedSafetyFact, type ResolvedSafetyKind, type ResolvedSafetyReport, type RulesInventoryCandidate, type RulesInventoryResult, type SemanticDependency, type SemanticDependencyKind, type StatusActivationSlice, type StatusCheckVerdict, type StatusLastCheckSlice, type StatusManifest, type StatusManifestFacts, type StatusNextAction, type StatusProjectIdentitySlice, type StatusRulesSlice, type StatusWritePathClass, type ValidateAgentSkillDocumentInput, type ValidateAgentSkillsPackageResult, adapterDocsCodePath, adapterFindingOccurrenceTargetKeys, adapterFindingRefFromTargetKey, adapterFindingTargetKey, agentProjectionContentIdentity, agentSkillEntryRelativePath, agentSkillPackageFileRelativePath, analyzeArchitectureConvergence, analyzeChange, analyzePolicyDelta, analyzeProject, analyzeResolvedProject, buildAgentProjectionBeginMarker, buildAgentProjectionBlock, buildAgentProjectionBody, buildAgentProjectionMeta, buildArkRuleFileHints, buildEffectiveArkRules, buildRulesInventory, buildStatusManifest, canPromoteInvariant, catalogFixForRuleId, catalogWhyForRuleId, classifyArkPolicyDelta, classifyStatusWritePath, collectAnalysisConfigWarnings, collectEmptyAppliesToFindings, collectForbiddenCapabilityUses, createAICodeGate, createAdapterResult, createArchitectureProfile, createArchitectureProfileFromArkConfig, createElevenLayerArkConfig, createProjectId, createProjectIdentity, createResolvedCandidateFacts, defaultHonestLabel, deriveArkRuleFileHints, detectArchitectureCycles, deterministicHash, diagnosticDocsFragment, diagnosticDocsPath, effectiveContractPolicyPayload, elevenLayerProfile, emptyEffectiveArkRules, evaluateArchitectureGraph, evaluateArkRuleSensors, evaluateInvariantCoverage, evaluateStatusBinding, explainViolation, extractAgentProjectionBlock, extractClassShapesFromSource, extractSemanticDependencies, flatSkillTemplateFileRelativePath, formatAgentProjectionCatalogShortList, formatAgentProjectionLayers, getDiagnosticCatalogEntry, inventoryToExtractionCard, isArkSkillName, isCataloguedOrArkRuleFamily, isKnownDiagnosticCode, isValidAgentSkillName, loadArkConfigContract, loadArkRulesContract, loadContract, loadResolvedCandidateFacts, mergeAgentProjectionDocument, normalizeSkillContent, parseAgentProjectionStamp, parseArkConfigJson, parseArkRulesJson, parseSkillDocument, policyDeltaAcknowledgementMatches, preflightChange, preflightResolvedChange, projectionHasNonEnforcementLabel, projectionMatchesPackageVersion, resolveEffectiveContract, resolveStatusNextAction, resolvedFactsEvidenceRequirementsHash, serializeDiagnosticCatalog, stableSerialize, toAdapterDiagnostic, validateAgentSkillDocument, validateAgentSkillsPackage, version };
3720
+ export { ADAPTER_DIAGNOSTIC_DOCS_RELATIVE_PATH, AGENT_PROJECTION_BEGIN_MARKER, AGENT_PROJECTION_END_MARKER, AGENT_PROJECTION_ENFORCEMENT_SURFACES, AGENT_PROJECTION_NON_ENFORCEMENT_LABEL, AGENT_SKILLS_PACKAGE_RELATIVE_ROOT, AGENT_SKILL_ENTRY_FILENAME, type AICodeGate, type AICodeGateContext, type AICodeGateOptions, type AICodeGateResult, type AICodeGateViolation, type AIGateExtension, ANALYSIS_IR_SCHEMA_VERSION, ARK_AGENT_PROJECTION_SCHEMA_VERSION, ARK_AGENT_SKILLS_PACKAGE_SCHEMA_VERSION, ARK_ANALYSIS_RESULT_SCHEMA, ARK_ANALYSIS_RESULT_SCHEMA_VERSION, ARK_CONFIG_SCHEMA, ARK_CONFIG_SCHEMA_VERSION, ARK_DESIGN_DELTA_SCHEMA_VERSION, ARK_ENFORCEMENT_STATE_SCHEMA_VERSION, ARK_IMPROVEMENT_COMPASS_SCHEMA_VERSION, ARK_PROJECT_IDENTITY_SCHEMA, ARK_PROJECT_IDENTITY_SCHEMA_URL, ARK_PROJECT_IDENTITY_SCHEMA_VERSION, ARK_RULES_SCHEMA, ARK_RULES_SCHEMA_VERSION, ARK_RULE_SENSORS, ARK_SKILL_NAMES, ARK_SKILL_NAME_COUNT, ARK_STATUS_MANIFEST_SCHEMA, ARK_STATUS_MANIFEST_SCHEMA_URL, ARK_STATUS_MANIFEST_SCHEMA_VERSION, type AdapterCompletenessReason, type AdapterDiagnostic, type AdapterResult, type AdapterSeverity, type AdapterViolationInput, type AgentProjectionCatalogEntry, type AgentProjectionFacts, type AgentProjectionLayerSummary, type AgentProjectionMergeAction, type AgentProjectionMergeResult, type AgentProjectionMeta, type AgentProjectionProfile, type AgentSkillPackageEntry, type AgentSkillValidationIssue, type AnalysisCapabilityUse, type AnalysisCompilerOptions, type AnalysisCompleteness, type AnalysisContract, type AnalysisEvidence, type AnalysisFile, type AnalysisFileChange, type AnalysisFileInput, type AnalysisImportEdge, type AnalysisIr, type AnalysisMode, type AnalysisResult, type AnalysisViolation, type AnalyzeArchitectureConvergenceInput, type AnalyzeChangeInput, type AnalyzePolicyDeltaInput, type AnalyzeProjectInput, type AnalyzeResolvedProjectInput, type ArchitectureActualChange, type ArchitectureChangeMap, type ArchitectureChangeMapContract, type ArchitectureChangeMapDependency, type ArchitectureChangeMapFile, type ArchitectureChangeOperation, type ArchitectureConvergenceClassification, type ArchitectureConvergenceFinding, type ArchitectureConvergenceResult, type ArchitectureDependency, type ArchitectureEngineEdge, type ArchitectureEngineResult, type ArchitectureEngineViolation, type ArchitectureLayer, type ArchitectureLayerConfig, type ArchitectureProfile, type ArchitectureRule, type ArkCheckConfig, ArkConfig, ArkConfigLoadResult, type ArkDesignDeltaResult, type ArkEnforcementHost, type ArkEnforcementState, type ArkRuleSensorViolation, type ArkRulesFile, type ArkSkillName, type ChangePreflightResult, type ClassShapeFact, type CollectAnalysisConfigWarningsInput, type CreateArchitectureProfileFromArkConfigOptions, type CreateArchitectureProfileOptions, type CreateElevenLayerArkConfigOptions, DEFAULT_AGENT_PROJECTION_RULE_IDS, DIAGNOSTIC_CATALOG, DIAGNOSTIC_CATALOG_SCHEMA_VERSION, DIAGNOSTIC_DOCS_RELATIVE_PATH, DIAGNOSTIC_RULE_IDS, type DesignDeltaChange, type DesignDeltaIdentity, type DesignSmellEvidence, type DesignSmellFinding, type DesignSmellId, type DiagnosticCatalogEntry, type DiagnosticCategory, type EffectiveArkRules, type EffectiveContract, EffectiveContractError, type EffectiveContractWarning, type EnforcementBoundaryState, type EnforcementEvidence, type EnforcementEvidenceField, type EnforcementVerification, type EvaluateArchitectureGraphInput, FLAT_SKILL_TEMPLATES_RELATIVE_ROOT, type ForbiddenCapabilityUse, IMPROVEMENT_COMPASS_OUT_OF_SCOPE_LENSES, IMPROVEMENT_COMPASS_TOP_RESIDUAL_CAP, IMPROVEMENT_LENS_IDS, type ImprovementCompass, type ImprovementCompassEvidence, type ImprovementCompassFacts, type ImprovementCompassNextAction, type ImprovementCompassSmellFact, type ImprovementCompassViolationFact, type ImprovementLens, type ImprovementLensId, type ImprovementLensStatus, type InvariantCoverageEvidence, POLICY_DELTA_SCHEMA_VERSION, PROJECT_BINDING_SCHEMA, PROJECT_EXPECTATION_SCHEMA, type ParseSkillDocumentResult, type ParsedSkillFrontmatter, type PolicyDelta, type PolicyDeltaAcknowledgement, type PolicyDeltaAnalysis, type PolicyDeltaClassification, type PolicyDeltaFinding, type PreflightResolvedChangeInput, type PreparedChangeFile, type ProjectBinding, type ProjectExpectation, type ProjectIdentity, RESOLVED_CANDIDATE_FACTS_SCHEMA, RESOLVED_CANDIDATE_FACTS_SCHEMA_VERSION, type ResolvedAmbientFact, type ResolvedAnalysisFile, type ResolvedAnalysisIr, type ResolvedAnalysisResult, type ResolvedCandidateFacts, type ResolvedCandidateFactsInput, type ResolvedCapability, type ResolvedCapabilityFact, type ResolvedChangePreflightResult, type ResolvedDependencyFact, type ResolvedDependencyKind, type ResolvedDependencyState, type ResolvedFactsCompleteness, type ResolvedFactsReason, type ResolvedFileFact, type ResolvedIntentReferenceFact, type ResolvedPublishFact, type ResolvedSafetyFact, type ResolvedSafetyKind, type ResolvedSafetyReport, type RulesInventoryCandidate, type RulesInventoryResult, STATUS_COMPASS_FACTS_SOURCES, STATUS_COMPASS_MODES, STATUS_COMPASS_REASON_CODES, type SemanticDependency, type SemanticDependencyKind, type StatusActivationSlice, type StatusCheckVerdict, type StatusCompassFactsSource, type StatusCompassMode, type StatusCompassReasonCode, type StatusImprovementCompassSlice, type StatusLastCheckSlice, type StatusManifest, type StatusManifestFacts, type StatusNextAction, type StatusProjectIdentitySlice, type StatusRulesSlice, type StatusWritePathClass, type ValidateAgentSkillDocumentInput, type ValidateAgentSkillsPackageResult, adapterDocsCodePath, adapterFindingOccurrenceTargetKeys, adapterFindingRefFromTargetKey, adapterFindingTargetKey, agentProjectionContentIdentity, agentSkillEntryRelativePath, agentSkillPackageFileRelativePath, analyzeArchitectureConvergence, analyzeChange, analyzePolicyDelta, analyzeProject, analyzeResolvedProject, buildAgentProjectionBeginMarker, buildAgentProjectionBlock, buildAgentProjectionBody, buildAgentProjectionMeta, buildArkRuleFileHints, buildEffectiveArkRules, buildImprovementCompass, buildRulesInventory, buildStatusManifest, canPromoteInvariant, catalogFixForRuleId, catalogWhyForRuleId, classifyArkPolicyDelta, classifyStatusWritePath, collectAnalysisConfigWarnings, collectEmptyAppliesToFindings, collectForbiddenCapabilityUses, createAICodeGate, createAdapterResult, createArchitectureProfile, createArchitectureProfileFromArkConfig, createElevenLayerArkConfig, createProjectId, createProjectIdentity, createResolvedCandidateFacts, defaultHonestLabel, deriveArkRuleFileHints, detectArchitectureCycles, deterministicHash, diagnosticDocsFragment, diagnosticDocsPath, effectiveContractPolicyPayload, elevenLayerProfile, emptyEffectiveArkRules, evaluateArchitectureGraph, evaluateArkRuleSensors, evaluateInvariantCoverage, evaluateStatusBinding, explainViolation, extractAgentProjectionBlock, extractClassShapesFromSource, extractSemanticDependencies, flatSkillTemplateFileRelativePath, formatAgentProjectionCatalogShortList, formatAgentProjectionLayers, formatImprovementCompassDoctorLines, formatImprovementCompassResidualLabels, getDiagnosticCatalogEntry, inventoryToExtractionCard, isArkSkillName, isCataloguedOrArkRuleFamily, isKnownDiagnosticCode, isValidAgentSkillName, loadArkConfigContract, loadArkRulesContract, loadContract, loadResolvedCandidateFacts, mergeAgentProjectionDocument, normalizeSkillContent, normalizeStatusImprovementCompass, parseAgentProjectionStamp, parseArkConfigJson, parseArkRulesJson, parseSkillDocument, policyDeltaAcknowledgementMatches, preflightChange, preflightResolvedChange, primaryImprovementCompassNextAction, projectStatusImprovementCompass, projectionHasNonEnforcementLabel, projectionMatchesPackageVersion, resolveEffectiveContract, resolveStatusNextAction, resolvedFactsEvidenceRequirementsHash, serializeDiagnosticCatalog, stableSerialize, statusCompassResidualIsSubsetOfDoctor, toAdapterDiagnostic, unavailableStatusImprovementCompass, validateAgentSkillDocument, validateAgentSkillsPackage, version };