@qlucent/fishi-core 0.8.0 → 0.11.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.
package/dist/index.d.ts CHANGED
@@ -5,7 +5,7 @@ type CostMode = 'performance' | 'balanced' | 'economy';
5
5
  type ModelTier = 'opus' | 'sonnet' | 'haiku';
6
6
  type TaskStatus = 'backlog' | 'ready' | 'in_progress' | 'review' | 'done' | 'blocked';
7
7
  type GateStatus = 'pending' | 'approved' | 'rejected' | 'skipped';
8
- type AgentRole = 'master' | 'coordinator' | 'worker';
8
+ type AgentRole$1 = 'master' | 'coordinator' | 'worker';
9
9
  interface FishiConfig {
10
10
  version: string;
11
11
  project: ProjectConfig;
@@ -76,7 +76,7 @@ interface McpServerConfig {
76
76
  interface AgentDefinition {
77
77
  name: string;
78
78
  description: string;
79
- role: AgentRole;
79
+ role: AgentRole$1;
80
80
  tools: string[];
81
81
  model: ModelTier;
82
82
  isolation?: 'worktree';
@@ -171,6 +171,16 @@ declare function writingAgentTemplate(ctx: TemplateContext): string;
171
171
 
172
172
  declare function marketingAgentTemplate(ctx: TemplateContext): string;
173
173
 
174
+ declare function getSaasArchitectTemplate(): string;
175
+
176
+ declare function getMarketplaceArchitectTemplate(): string;
177
+
178
+ declare function getMobileArchitectTemplate(): string;
179
+
180
+ declare function getAimlArchitectTemplate(): string;
181
+
182
+ declare function getDeepResearchAgentTemplate(): string;
183
+
174
184
  declare function getBrainstormingSkill(): string;
175
185
 
176
186
  declare function getBrownfieldAnalysisSkill(): string;
@@ -201,6 +211,8 @@ declare function getAdaptiveTaskGraphSkill(): string;
201
211
  */
202
212
  declare function getDocumentationSkill(): string;
203
213
 
214
+ declare function getDeepResearchSkill(): string;
215
+
204
216
  /**
205
217
  * Session Start Hook Template
206
218
  *
@@ -435,6 +447,10 @@ declare function getGitignoreAdditions(): string;
435
447
 
436
448
  declare function getModelRoutingReference(): string;
437
449
 
450
+ declare function getSoulMdTemplate(): string;
451
+
452
+ declare function getAgentsMdTemplate(): string;
453
+
438
454
  /**
439
455
  * Agent Factory Template
440
456
  *
@@ -453,6 +469,33 @@ declare function getAgentFactoryTemplate(): string;
453
469
  */
454
470
  declare function getCoordinatorFactoryTemplate(): string;
455
471
 
472
+ type ProjectDomain = 'saas' | 'marketplace' | 'mobile' | 'aiml' | 'general';
473
+ interface DomainConfig {
474
+ domain: ProjectDomain;
475
+ domainAgent: string | null;
476
+ researchEnabled: boolean;
477
+ }
478
+ declare const DOMAIN_INFO: Record<ProjectDomain, {
479
+ label: string;
480
+ description: string;
481
+ agent: string | null;
482
+ }>;
483
+ /**
484
+ * Get the list of available domains for selection.
485
+ */
486
+ declare function getAvailableDomains(): {
487
+ value: ProjectDomain;
488
+ name: string;
489
+ }[];
490
+ /**
491
+ * Read domain config from fishi.yaml.
492
+ */
493
+ declare function readDomainConfig(projectDir: string): DomainConfig;
494
+ /**
495
+ * Get the domain config YAML to append to fishi.yaml.
496
+ */
497
+ declare function getDomainConfigYaml(domain: ProjectDomain): string;
498
+
456
499
  type ConflictResolution = 'skip' | 'merge' | 'replace';
457
500
  interface FileResolutionMap {
458
501
  categories: Record<string, ConflictResolution>;
@@ -465,6 +508,7 @@ interface ScaffoldOptions extends InitOptions {
465
508
  resolutions?: FileResolutionMap;
466
509
  docsReadmeExists?: boolean;
467
510
  rootClaudeMdExists?: boolean;
511
+ domain?: ProjectDomain;
468
512
  }
469
513
  interface ScaffoldResult {
470
514
  agentCount: number;
@@ -643,10 +687,95 @@ declare function startDevServer(projectDir: string, config: DevServerConfig): Ch
643
687
  */
644
688
  declare function getVibeModeConfig(enabled: boolean): string;
645
689
 
690
+ interface DesignTokens {
691
+ colors: Record<string, string>;
692
+ typography: {
693
+ fontFamilies: string[];
694
+ scale: Record<string, string>;
695
+ };
696
+ spacing: Record<string, string>;
697
+ borderRadius: Record<string, string>;
698
+ shadows: Record<string, string>;
699
+ darkMode: boolean;
700
+ }
701
+ interface ComponentEntry {
702
+ name: string;
703
+ path: string;
704
+ type: 'ui' | 'layout' | 'form' | 'data' | 'navigation' | 'other';
705
+ }
706
+ interface ComponentRegistry {
707
+ components: ComponentEntry[];
708
+ library: string | null;
709
+ framework: string | null;
710
+ }
711
+ interface BrandGuardianIssue {
712
+ file: string;
713
+ line: number;
714
+ severity: 'error' | 'warning' | 'info';
715
+ rule: string;
716
+ message: string;
717
+ fix?: string;
718
+ }
719
+ interface BrandGuardianReport {
720
+ issues: BrandGuardianIssue[];
721
+ passed: boolean;
722
+ stats: {
723
+ errors: number;
724
+ warnings: number;
725
+ infos: number;
726
+ filesScanned: number;
727
+ };
728
+ }
729
+ /**
730
+ * Detect design tokens from a project's config files.
731
+ * Checks: tailwind.config, CSS custom properties, theme files.
732
+ */
733
+ declare function detectDesignTokens(projectDir: string): DesignTokens;
734
+ /**
735
+ * Generate default design tokens for a new project.
736
+ */
737
+ declare function generateDefaultTokens(): DesignTokens;
738
+ /**
739
+ * Detect component library and registry from a project.
740
+ */
741
+ declare function detectComponentRegistry(projectDir: string): ComponentRegistry;
742
+ /**
743
+ * Run Brand Guardian validation on project files.
744
+ * Checks for hardcoded colors, inconsistent spacing, missing a11y, etc.
745
+ */
746
+ declare function runBrandGuardian(projectDir: string, tokens: DesignTokens): BrandGuardianReport;
747
+ /**
748
+ * Generate a design system config file for the project.
749
+ */
750
+ declare function generateDesignSystemConfig(tokens: DesignTokens, registry: ComponentRegistry): string;
751
+
752
+ type AgentRole = 'master' | 'coordinator' | 'worker';
753
+ interface AgentPermissionSet {
754
+ role: AgentRole;
755
+ allow: string[];
756
+ deny: string[];
757
+ }
758
+ /**
759
+ * Get tool permissions for a specific agent role.
760
+ * Master: read-only + delegation. Coordinators: read/write + git. Workers: full dev in sandbox.
761
+ */
762
+ declare function getPermissionsForRole(role: AgentRole): AgentPermissionSet;
763
+ /**
764
+ * Get all permission sets as a summary for display.
765
+ */
766
+ declare function getAllPermissionSummary(): Record<AgentRole, {
767
+ allowCount: number;
768
+ denyCount: number;
769
+ }>;
770
+ /**
771
+ * Generate per-agent permission YAML block for settings.json or agent definition.
772
+ */
773
+ declare function generatePermissionBlock(role: AgentRole): string;
774
+
646
775
  declare function getSandboxPolicyTemplate(): string;
647
776
 
648
777
  declare function getDockerfileTemplate(): string;
649
778
 
650
779
  declare function getDashboardHtml(): string;
651
780
 
652
- export { type AgentDefinition, type AgentRole, type AgentTemplate, type BackupManifest, type BrownfieldAnalysisData, type ClaudeMdOptions, type CommandTemplate, type ConflictCategory, type ConflictMap, type ConflictResolution, type CostMode, type DetectionCheck, type DetectionResult, type DevServerConfig, type DynamicAgent, type DynamicAgentConfig, type ExecutionConfig, type FileConflict, type FileResolutionMap, type FishiConfig, type FishiYamlOptions, type GateConfig, type GateStatus, type GitConfig, type HookTemplate, type InitOptions, type McpConfig, type McpServerConfig, type ModelRoutingConfig, type ModelTier, type MonitorEvent, type MonitorState, type MonitorSummary, type ProjectConfig, type ProjectType, type ProjectYamlOptions, type SandboxConfig, type SandboxMode, type SandboxPolicy, type SandboxRunResult, type ScaffoldOptions, type ScaffoldResult, type SkillTemplate, type StateConfig, type TaskStatus, type TaskboardConfig, type TemplateContext, architectAgentTemplate, backendAgentTemplate, buildSandboxEnv, createBackup, detectConflicts, detectDevServer, detectDocker, devLeadTemplate, devopsAgentTemplate, docsAgentTemplate, emitEvent, frontendAgentTemplate, fullstackAgentTemplate, generateScaffold, getAdaptiveTaskGraphSkill, getAgentCompleteHook, getAgentFactoryTemplate, getAgentRegistryTemplate, getAgentSummary, getApiDesignSkill, getAutoCheckpointHook, getBoardCommand, getBrainstormingSkill, getBrownfieldAnalysisSkill, getBrownfieldDiscoverySkill, getClaudeMdTemplate, getCodeGenSkill, getCoordinatorFactoryTemplate, getDashboardHtml, getDebuggingSkill, getDeploymentSkill, getDocCheckerScript, getDockerfileTemplate, getDocumentationSkill, getFishiYamlTemplate, getGateCommand, getGateManagerScript, getGitignoreAdditions, getInitCommand, getLearningsManagerScript, getMasterOrchestratorTemplate, getMcpJsonTemplate, getMemoryManagerScript, getModelRoutingReference, getMonitorEmitterScript, getPhaseRunnerScript, getPostEditHook, getPrdCommand, getPrdSkill, getProjectYamlTemplate, getResetCommand, getResumeCommand, getSafetyCheckHook, getSandboxPolicyTemplate, getSessionStartHook, getSettingsJsonTemplate, getSprintCommand, getStatusCommand, getTaskboardOpsSkill, getTaskboardUpdateHook, getTestingSkill, getTodoManagerScript, getValidateScaffoldScript, getVibeModeConfig, getWorktreeManagerScript, getWorktreeSetupHook, marketingAgentTemplate, mergeClaudeMd, mergeClaudeMdTop, mergeGitignore, mergeMcpJson, mergeSettingsJson, opsLeadTemplate, planningAgentTemplate, planningLeadTemplate, qualityLeadTemplate, readMonitorState, readSandboxConfig, readSandboxPolicy, researchAgentTemplate, runInDockerSandbox, runInProcessSandbox, runInSandbox, securityAgentTemplate, startDevServer, testingAgentTemplate, uiuxAgentTemplate, writingAgentTemplate };
781
+ export { type AgentDefinition, type AgentRole as AgentPermissionRole, type AgentPermissionSet, type AgentRole$1 as AgentRole, type AgentTemplate, type BackupManifest, type BrandGuardianIssue, type BrandGuardianReport, type BrownfieldAnalysisData, type ClaudeMdOptions, type CommandTemplate, type ComponentEntry, type ComponentRegistry, type ConflictCategory, type ConflictMap, type ConflictResolution, type CostMode, DOMAIN_INFO, type DesignTokens, type DetectionCheck, type DetectionResult, type DevServerConfig, type DomainConfig, type DynamicAgent, type DynamicAgentConfig, type ExecutionConfig, type FileConflict, type FileResolutionMap, type FishiConfig, type FishiYamlOptions, type GateConfig, type GateStatus, type GitConfig, type HookTemplate, type InitOptions, type McpConfig, type McpServerConfig, type ModelRoutingConfig, type ModelTier, type MonitorEvent, type MonitorState, type MonitorSummary, type ProjectConfig, type ProjectDomain, type ProjectType, type ProjectYamlOptions, type SandboxConfig, type SandboxMode, type SandboxPolicy, type SandboxRunResult, type ScaffoldOptions, type ScaffoldResult, type SkillTemplate, type StateConfig, type TaskStatus, type TaskboardConfig, type TemplateContext, architectAgentTemplate, backendAgentTemplate, buildSandboxEnv, createBackup, detectComponentRegistry, detectConflicts, detectDesignTokens, detectDevServer, detectDocker, devLeadTemplate, devopsAgentTemplate, docsAgentTemplate, emitEvent, frontendAgentTemplate, fullstackAgentTemplate, generateDefaultTokens, generateDesignSystemConfig, generatePermissionBlock, generateScaffold, getAdaptiveTaskGraphSkill, getAgentCompleteHook, getAgentFactoryTemplate, getAgentRegistryTemplate, getAgentSummary, getAgentsMdTemplate, getAimlArchitectTemplate, getAllPermissionSummary, getApiDesignSkill, getAutoCheckpointHook, getAvailableDomains, getBoardCommand, getBrainstormingSkill, getBrownfieldAnalysisSkill, getBrownfieldDiscoverySkill, getClaudeMdTemplate, getCodeGenSkill, getCoordinatorFactoryTemplate, getDashboardHtml, getDebuggingSkill, getDeepResearchAgentTemplate, getDeepResearchSkill, getDeploymentSkill, getDocCheckerScript, getDockerfileTemplate, getDocumentationSkill, getDomainConfigYaml, getFishiYamlTemplate, getGateCommand, getGateManagerScript, getGitignoreAdditions, getInitCommand, getLearningsManagerScript, getMarketplaceArchitectTemplate, getMasterOrchestratorTemplate, getMcpJsonTemplate, getMemoryManagerScript, getMobileArchitectTemplate, getModelRoutingReference, getMonitorEmitterScript, getPermissionsForRole, getPhaseRunnerScript, getPostEditHook, getPrdCommand, getPrdSkill, getProjectYamlTemplate, getResetCommand, getResumeCommand, getSaasArchitectTemplate, getSafetyCheckHook, getSandboxPolicyTemplate, getSessionStartHook, getSettingsJsonTemplate, getSoulMdTemplate, getSprintCommand, getStatusCommand, getTaskboardOpsSkill, getTaskboardUpdateHook, getTestingSkill, getTodoManagerScript, getValidateScaffoldScript, getVibeModeConfig, getWorktreeManagerScript, getWorktreeSetupHook, marketingAgentTemplate, mergeClaudeMd, mergeClaudeMdTop, mergeGitignore, mergeMcpJson, mergeSettingsJson, opsLeadTemplate, planningAgentTemplate, planningLeadTemplate, qualityLeadTemplate, readDomainConfig, readMonitorState, readSandboxConfig, readSandboxPolicy, researchAgentTemplate, runBrandGuardian, runInDockerSandbox, runInProcessSandbox, runInSandbox, securityAgentTemplate, startDevServer, testingAgentTemplate, uiuxAgentTemplate, writingAgentTemplate };