@wrongstack/core 0.309.1 → 0.310.0

package/instructions/system.md

@@ -76,6 +76,21 @@ Before you write any new code — a function, a wrapper, a flag, a fallback path
 
 The ladder trims what **you** invented; it never shrinks what the user asked for. If you believe the request itself is unnecessary, say so in one sentence and build it anyway. Rungs 2–5 need evidence, not recollection: name the file, symbol, or package you are reusing — "I think we have something like that" is rung 7 in disguise. A new dependency is the user's decision, never a side effect. Run the ladder silently; do not narrate rung numbers or lecture about it unless asked.
 
+## Architecture discipline
+
+The five questions decide *whether* the change is right; the cost ladder decides *how much* it costs; this section decides *what shape* it takes. Maintainability, testability, and consistent structure outrank the fastest possible patch. These rules govern only the code you write or touch — they are never a license to refactor working neighbors; note violations in your summary instead.
+
+- **Boundaries (clean/hexagonal):** domain logic stays pure (no framework, SDK, or I/O imports); orchestration sits above it; DB drivers, external APIs, and third-party SDKs live behind adapters at the edge. Dependencies point inward.
+- **Program to interfaces** wherever a behavior has, or will plausibly have, more than one implementation; inject the concrete choice. Prefer composition over inheritance.
+- **Single responsibility:** past ~200 lines, evaluate whether two concerns got mixed; split along a seam rather than appending.
+- **Factory:** creation of dynamic or multi-provider services (payment gateways, AI models, storage drivers, notification channels) routes through a dedicated factory — never a bare constructor inside a handler.
+- **Singleton:** only for expensive shared resources (connection pools, loggers, cache managers); no global mutable-state leakage.
+- **Adapter:** third-party SDKs and external schemas never touch domain types. Map vendor shapes at the boundary so vendor churn stops there.
+- **Strategy:** when an `if`/`switch` selects between interchangeable algorithms or behaviors across more than two cases, extract an injected strategy instead of growing the branch.
+- **Observer/typed events:** decouple side-effects (audit logs, metrics, emails, notifications, cache invalidation) from the action that caused them.
+- Zero speculative dependencies or framework sprawl; strict typing and explicit error handling by default.
+- When scaffolding or adding a feature, state briefly which pattern you applied and why — one line each, not a lecture.
+
 <!--ws:if tool=todo-->
 ## Todo status lifecycle
 

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@wrongstack/core",
-  "version": "0.309.1",
+  "version": "0.310.0",
   "license": "MIT",
-  "description": "WrongStack core: kernel, types, defaults, and shared utilities for the WrongStack CLI agent.",
+  "description": "WrongStack core: kernel, types, and shared utilities for the WrongStack CLI agent.",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/WrongStack/WrongStack.git",
@@ -44,10 +44,6 @@
       "types": "./dist/core/model-ref.d.ts",
       "import": "./dist/core/model-ref.js"
     },
-    "./defaults": {
-      "types": "./dist/defaults/index.d.ts",
-      "import": "./dist/defaults/index.js"
-    },
     "./utils": {
       "types": "./dist/utils/index.d.ts",
       "import": "./dist/utils/index.js"
@@ -182,11 +178,12 @@
   "wrongstackApiVersion": "0.1.10",
   "dependencies": {
     "zod": "4.4.3",
-    "@wrongstack/kanban": "0.309.1",
-    "@wrongstack/persistence": "0.309.1"
+    "@wrongstack/primitives": "0.310.0",
+    "@wrongstack/kanban": "0.310.0",
+    "@wrongstack/persistence": "0.310.0"
   },
   "devDependencies": {
-    "@types/node": "^26.2.0",
+    "@types/node": "^22.19.0",
     "typescript": "^7.0.2"
   },
   "publishConfig": {

package/dist/defaults/index.d.ts

@@ -1,69 +0,0 @@
-export { createMessage, InMemoryAgentBridge, InMemoryBridgeTransport, } from '../coordination/agent-bridge.js';
-export { type AgentFactory, type AgentFactoryResult, type AgentRunnerOptions, makeAgentSubagentRunner, } from '../coordination/agent-subagent-runner.js';
-export { AGENT_CATALOG, AGENTS_BY_PHASE, type AgentBudgetTier, type AgentCapability, type AgentDefinition, type AgentPhase, ALL_AGENT_DEFINITIONS, getAgentDefinition, } from '../coordination/agents/index.js';
-export { type AutoExtendCeiling, type AutoExtendPolicy, attachAutoExtend, } from '../coordination/auto-extend.js';
-export { type CreateDelegateToolOptions, createDelegateTool, type DelegateHost, } from '../coordination/delegate-tool.js';
-export { Director, FleetSpawnBudgetError, } from '../coordination/director.js';
-export { composeDirectorPrompt, composeSubagentPrompt, DEFAULT_DIRECTOR_PREAMBLE, DEFAULT_SUBAGENT_BASELINE, type DirectorPromptParts, rosterSummaryFromConfigs, type SubagentPromptParts, } from '../coordination/director-prompts.js';
-export { type DirectorSessionFactory, type DirectorSessionFactoryOptions, makeDirectorSessionFactory, } from '../coordination/director-session.js';
-export { makeAskTool, makeAssignTool, makeAwaitTasksTool, makeCollabDebugTool, makeFleetEmitTool, makeFleetTool, makeRollUpTool, makeSpawnTool, makeTerminateTool, } from '../coordination/director-tools.js';
-export { DEFAULT_DISPATCH_ROLE, type DispatchCandidate, type DispatchClassifier, type DispatchMethod, type DispatchOptions, type DispatchResult, dispatchAgent, makeLLMClassifier, scoreAgents, } from '../coordination/dispatcher.js';
-export { ALL_FLEET_AGENTS, AUDIT_LOG_AGENT, applyRosterBudget, BUG_HUNTER_AGENT, FLEET_ROSTER, FLEET_ROSTER_BUDGETS, type FleetRosterBudget, REFACTOR_PLANNER_AGENT, SECURITY_SCANNER_AGENT, } from '../coordination/fleet.js';
-export { FleetBus, type FleetEvent, type FleetHandler, type FleetUsage, FleetUsageAggregator, type SubagentUsageSnapshot, } from '../coordination/fleet-bus.js';
-export type { ICoordinator } from '../coordination/icoordinator.js';
-export type { IFleetManager } from '../coordination/ifleet-manager.js';
-export { DefaultMultiAgentCoordinator, type MultiAgentCoordinatorOptions, } from '../coordination/multi-agent-coordinator.js';
-export { NULL_FLEET_BUS } from '../coordination/null-fleet-bus.js';
-export { BudgetExceededError, type BudgetKind, type BudgetLimits, type BudgetUsage, SubagentBudget, } from '../coordination/subagent-budget.js';
-export { AutoCompactionMiddleware } from '../execution/auto-compaction-middleware.js';
-export { installSubagentAutoCompaction } from '../execution/subagent-compaction.js';
-export { AutonomousRunner, type AutonomousRunnerOptions, type DoneCheckResult, DoneConditionChecker, } from '../execution/autonomous-runner.js';
-export { type AutonomyPromptContributorOptions, makeAutonomyPromptContributor, } from '../execution/autonomy-prompt-contributor.js';
-export { type CompactorOptions, DEFAULT_AUTONOMY_CONFIG, DEFAULT_CONTEXT_CONFIG, DEFAULT_TOOLS_CONFIG, HybridCompactor, } from '../execution/compactor.js';
-export { activateDesign, clearActiveKit, detectFrontendFile, detectFrontendIntent, getDesignState, installDesignStudioMiddleware, makeDesignDetectToolCallMiddleware, makeDesignDetectUserInputMiddleware, makeDesignStudioRequestMiddleware, makeDesignVerifyToolCallMiddleware, setActiveKit, setDesignOverrides, } from '../execution/design-detect.js';
-export { _resetDesignKitLoaderMemo, DefaultDesignKitLoader, type DesignKitLoaderOptions, getDesignKitLoader, resolveBundledDesignKitsDir, } from '../execution/design-kit-loader.js';
-export { classifyTokenValue, colorToHex, isColorToken, oklchToHex, parseOklch, } from '../execution/design-color.js';
-export { type MaterializeResult, materializeTokens, } from '../execution/design-materialize.js';
-export { type DesignAxis, type DesignVerifyReport, type DesignViolation, runDesignVerify, verifyFiles, } from '../execution/design-verify.js';
-export { resolveSemanticTune, SEMANTIC_TUNE_KNOBS, type SemanticTune, } from '../execution/design-tune.js';
-export { _resetDesignRulesCache, applyTokenOverrides, clearPersistedActiveKit, designProjectDir, type DesignOverrides, loadActiveKit, loadProjectDesignRules, type PersistedActiveKit, recordKitChoice, recordOverrides, } from '../execution/design-project-store.js';
-export { DefaultErrorHandler } from '../execution/error-handler.js';
-export { EternalAutonomyEngine, type EternalAutonomyOptions, type EternalEngineState, type IterationStage, } from '../execution/eternal-autonomy.js';
-export { buildGoalPreamble } from '../execution/goal-preamble.js';
-export { IntelligentCompactor, type IntelligentCompactorOptions, } from '../execution/intelligent-compactor.js';
-export { type ParallelEngineState, ParallelEternalEngine, type ParallelEternalOptions, type ParallelIterationStage, } from '../execution/parallel-eternal-engine.js';
-export { DefaultProviderRunner } from '../execution/provider-runner-impl.js';
-export { DefaultRetryPolicy } from '../execution/retry-policy.js';
-export { SelectiveCompactor, type SelectiveCompactorOptions, } from '../execution/selective-compactor.js';
-export { DefaultSkillLoader, type SkillLoaderOptions } from '../execution/skill-loader.js';
-export { DefaultPromptLoader, type PromptLoaderOptions, renderPrompt, } from '../execution/prompt-loader.js';
-export { type CompactorStrategy, createStrategyCompactor, type StrategyCompactorOptions, } from '../execution/strategy-compactor.js';
-export { ToolExecutor } from '../execution/tool-executor.js';
-export { type ContextManagerAction, type ContextManagerInput, type ContextManagerResult, type ContextManagerToolOptions, contextManagerTool, createContextManagerTool, } from '../infrastructure/context-manager.js';
-export { DefaultLogger, type DefaultLoggerOptions, type LogFormat, } from '../infrastructure/logger.js';
-export { allServers, awsServer, blockServer, braveSearchServer, context7Server, everArtServer, filesystemServer, githubServer, googleMapsServer, miniMaxVisionServer, playwrightServer, sentinelServer, slackServer, sshManagerServer, zaiVisionServer, } from '../infrastructure/mcp-servers.js';
-export { CODEX_MODELS, type CodexModelMeta, codexModelMeta } from '../models/codex-catalog.js';
-export { LLMSelector, type LLMSelectorOptions } from '../models/llm-selector.js';
-export { DefaultModeStore, loadProjectModes, loadUserModes, type ModeLoaderOptions, } from '../models/mode-store.js';
-export { classifyFamily, DefaultModelsRegistry, type DefaultModelsRegistryOptions, } from '../models/models-registry.js';
-export { describeCatalogModel, type ProviderModelDescriptor, resolveProviderModelList, } from '../models/provider-model-resolve.js';
-export { buildOtlpMetricsRequest, buildOtlpTracesRequest, DefaultHealthRegistry, InMemoryMetricsSink, type MetricsServerHandle, type MetricsServerOptions, NoopMetricsSink, NoopTracer, OTelTracer, type OtlpMetricsExporterHandle, type OtlpMetricsExporterOptions, type OtlpTraceExporterHandle, type OtlpTraceExporterOptions, PROMETHEUS_CONTENT_TYPE, renderPrometheus, startMetricsServer, startOtlpMetricsExporter, startOtlpTraceExporter, wireMetricsToEvents, } from '../observability/index.js';
-export { AutoApprovePermissionPolicy, DefaultPermissionPolicy, type PermissionPolicyOptions, } from '../security/permission-policy.js';
-export { DefaultSecretScrubber } from '../security/secret-scrubber.js';
-export { DefaultSecretVault, migratePlaintextSecrets, rewriteConfigEncrypted, type SecretVaultOptions, } from '../security/secret-vault.js';
-export { decryptConfigSecrets, encryptConfigSecrets } from '../security/config-secrets.js';
-export { type AttachmentStoreOptions, DefaultAttachmentStore, } from '../storage/attachment-store.js';
-export { type ConfigLoaderOptions, type ConfigSource, DefaultConfigLoader, } from '../storage/config-loader.js';
-export { type ConfigMigration, ConfigMigrationError, DEFAULT_CONFIG_MIGRATIONS, type MigrationContext, type MigrationResult, runConfigMigrations, } from '../storage/config-migration.js';
-export { DefaultConfigStore } from '../storage/config-store.js';
-export { DirectorStateCheckpoint, type DirectorStateSnapshot, type DirectorSubagentState, type DirectorTaskState, loadDirectorState, } from '../storage/director-state.js';
-export { addPlanItem, attachPlanCheckpoint, clearPlan, deriveTodosFromPlanItem, emptyPlan, formatPlan, loadPlan, type PlanFile, type PlanItem, removePlanItem, savePlan, setPlanItemStatus, } from '../storage/plan-store.js';
-export { formatPlanTemplates, getPlanTemplate, listPlanTemplates, type PlanTemplate, } from '../storage/plan-templates.js';
-export { type PersistedQueueItem, QueueStore, } from '../storage/queue-store.js';
-export { type AbandonedSession, RecoveryLock, type RecoveryLockOptions, } from '../storage/recovery-lock.js';
-export { SessionAnalyzer } from '../storage/session-analyzer.js';
-export { type AuditLevel, createSessionEventBridge, resolveAuditLevel, resolveSessionLoggingConfig, type SessionEventBridge, type SessionEventBridgeOptions, type SessionSamplingOptions, type ToolProgressSamplingOptions, } from '../storage/session-event-bridge.js';
-export { DefaultSessionReader } from '../storage/session-reader.js';
-export { DefaultSessionStore, type SessionStoreOptions, } from '../storage/session-store.js';
-export { attachTodosCheckpoint, loadTodosCheckpoint, saveTodosCheckpoint, type TodosCheckpointFile, } from '../storage/todos-checkpoint.js';
-//# sourceMappingURL=index.d.ts.map