tycono 0.3.45-beta.2 → 0.3.45-beta.3

package/src/api/src/services/preset-loader.ts

@@ -1,149 +0,0 @@
-/**
- * preset-loader.ts — Load presets from knowledge/presets/
- *
- * Scans knowledge/presets/ for:
- *   - _default.yaml (auto-generated from existing knowledge/roles/)
- *   - {name}/preset.yaml (installed presets with roles/skills/knowledge)
- *
- * Returns PresetSummary[] for TUI display and full LoadedPreset for wave creation.
- */
-import fs from 'node:fs';
-import path from 'node:path';
-import YAML from 'yaml';
-import type { PresetDefinition, LoadedPreset, PresetSummary } from '../../../shared/types.js';
-
-const PRESETS_DIR = 'knowledge/presets';
-const DEFAULT_PRESET_FILE = '_default.yaml';
-
-/**
- * Build a default preset definition from existing roles/ directory.
- * This is generated on-the-fly — no need to persist _default.yaml.
- */
-function buildDefaultPreset(companyRoot: string): LoadedPreset {
-  const rolesDir = path.join(companyRoot, 'knowledge', 'roles');
-  const roles: string[] = [];
-
-  if (fs.existsSync(rolesDir)) {
-    const entries = fs.readdirSync(rolesDir, { withFileTypes: true });
-    for (const entry of entries) {
-      if (!entry.isDirectory()) continue;
-      const yamlPath = path.join(rolesDir, entry.name, 'role.yaml');
-      if (fs.existsSync(yamlPath)) {
-        roles.push(entry.name);
-      }
-    }
-  }
-
-  return {
-    definition: {
-      spec: 'preset/v1',
-      id: 'default',
-      name: 'Default Team',
-      tagline: 'Your current team',
-      version: '1.0.0',
-      roles,
-    },
-    path: null,
-    isDefault: true,
-  };
-}
-
-/**
- * Load a single preset from a directory containing preset.yaml.
- */
-function loadPresetFromDir(presetDir: string): LoadedPreset | null {
-  const yamlPath = path.join(presetDir, 'preset.yaml');
-  if (!fs.existsSync(yamlPath)) return null;
-
-  try {
-    const raw = YAML.parse(fs.readFileSync(yamlPath, 'utf-8')) as PresetDefinition;
-    if (!raw.id || !raw.name || !Array.isArray(raw.roles)) return null;
-
-    return {
-      definition: {
-        spec: raw.spec || 'preset/v1',
-        id: raw.id,
-        name: raw.name,
-        tagline: raw.tagline,
-        version: raw.version || '1.0.0',
-        description: raw.description,
-        author: raw.author,
-        category: raw.category,
-        industry: raw.industry,
-        stage: raw.stage,
-        use_case: raw.use_case,
-        roles: raw.roles,
-        knowledge_docs: raw.knowledge_docs,
-        skills_count: raw.skills_count,
-        pricing: raw.pricing,
-        tags: raw.tags,
-        languages: raw.languages,
-        stats: raw.stats,
-        wave_scoped: raw.wave_scoped,
-      },
-      path: presetDir,
-      isDefault: false,
-    };
-  } catch {
-    return null;
-  }
-}
-
-/**
- * Load all presets from knowledge/presets/ + auto-generated default.
- * Returns [default, ...installed] — default is always first.
- */
-export function loadPresets(companyRoot: string): LoadedPreset[] {
-  const presets: LoadedPreset[] = [];
-
-  // 1. Default preset (always present)
-  const defaultPreset = buildDefaultPreset(companyRoot);
-
-  // Check if _default.yaml exists with overrides
-  const defaultYamlPath = path.join(companyRoot, PRESETS_DIR, DEFAULT_PRESET_FILE);
-  if (fs.existsSync(defaultYamlPath)) {
-    try {
-      const raw = YAML.parse(fs.readFileSync(defaultYamlPath, 'utf-8')) as Partial<PresetDefinition>;
-      if (raw.name) defaultPreset.definition.name = raw.name;
-      if (raw.tagline) defaultPreset.definition.tagline = raw.tagline;
-      if (raw.description) defaultPreset.definition.description = raw.description;
-    } catch { /* ignore malformed _default.yaml */ }
-  }
-
-  presets.push(defaultPreset);
-
-  // 2. Installed presets from knowledge/presets/{name}/preset.yaml
-  const presetsDir = path.join(companyRoot, PRESETS_DIR);
-  if (fs.existsSync(presetsDir)) {
-    const entries = fs.readdirSync(presetsDir, { withFileTypes: true });
-    for (const entry of entries) {
-      if (!entry.isDirectory()) continue;
-      const preset = loadPresetFromDir(path.join(presetsDir, entry.name));
-      if (preset) presets.push(preset);
-    }
-  }
-
-  return presets;
-}
-
-/**
- * Get preset summaries for TUI display.
- */
-export function getPresetSummaries(companyRoot: string): PresetSummary[] {
-  return loadPresets(companyRoot).map(p => ({
-    id: p.definition.id,
-    name: p.definition.name,
-    description: p.definition.description ?? p.definition.tagline,
-    rolesCount: p.definition.roles.length,
-    roles: p.definition.roles,
-    isDefault: p.isDefault,
-  }));
-}
-
-/**
- * Find a specific preset by ID.
- */
-export function getPresetById(companyRoot: string, presetId: string): LoadedPreset | null {
-  const presets = loadPresets(companyRoot);
-  return presets.find(p => p.definition.id === presetId) ?? null;
-}

package/templates/CLAUDE.md.tmpl

@@ -1,239 +0,0 @@
-# Company Rules
-
-> Powered by [Tycono](https://tycono.ai) — AI Company Operating Platform
-
----
-
-## Task Routing
-
-| Task | Read First | Role |
-|------|-----------|------|
-| Product planning | `projects/` | PM |
-| Technical design | `architecture/` | CTO |
-| Implementation | `projects/*/tasks.md` | Engineer |
-| UI/UX Design | `projects/*/design/` | Designer |
-| Testing/QA | `projects/*/tasks.md` | QA |
-| E2E Testing | `e2e-experiments/tui-e2e-testcases.md` | QA |
-| Operations | `marketing/` | PM |
-| Business/Revenue | `company.md` | CBO |
-| Domain knowledge | `knowledge.md` | CBO |
-
----
-
-## AKB Core Concepts
-
-> **AKB** = A file-based knowledge system where AI uses **search (Grep/Glob)** to find and **contextual links** to navigate
->
-> Full reference: `methodologies/agentic-knowledge-base.md`
-
-| Layer | Role | AI Usage |
-|-------|------|----------|
-| **Root** (CLAUDE.md) | Minimal routing | Auto-injected as system prompt |
-| **Hub** ({folder}.md) | TOC + tool/guide references | **Check before starting work** |
-| **Node** (*.md) | Actual information | Search directly via Grep/Glob |
-
----
-
-## AI Work Rules
-
-### The Loop (Work Cycle)
-
-Every task follows this cycle. Implementing without completing the cycle is only half the job.
-
-| Step | Action | Why |
-|------|--------|-----|
-| ① Knowledge | Check/research related docs | Without context, direction goes wrong |
-| ② Task | Define task from docs | Without requirements, you'll rework |
-| ③ Implement | Execute the actual work | Value creation |
-| ④ Knowledge Update | Update docs with new insights | Prevents knowledge decay |
-| ⑤ Task Update | Update task status, check next work | Ensures continuity |
-
-**C-Level**: Execute The Loop autonomously — decompose tasks, analyze dependencies, dispatch independent tasks in parallel, collect results.
-**Member**: After implementation, always complete steps ④ and ⑤.
-
-### Hub-First Principle
-
-> ⛔ **Read the relevant Hub document before starting any work.**
-
-Check the Task Routing table above to find the right "Read First" path.
-Every folder has a Hub file (`{folder-name}.md`) as its entry point.
-Read the Hub's existing tools/scripts/guides before starting work.
-
-### Skill Check Principle
-
-> ⛔ **If `.claude/skills/{role-id}/SKILL.md` exists, you MUST read it.**
-
-Skill files define the tools, commands, and guides for each Role.
-Working without reading skills means missing existing tools and starting from scratch.
-
-### Custom Rules (CRITICAL)
-
-> ⛔ **Before starting work, check if `custom-rules.md` exists and read it.**
-> This file contains company-specific rules, constraints, and processes.
-> If the file doesn't exist, ignore this section.
-
-### Git Rules
-
-- Source code changes: feature branch → PR → merge
-- Direct push to main is prohibited
-
-### Knowledge Gate
-
-> **Before creating a new document, search existing docs first.**
-
-```
-1. Summarize the insight + 3-5 keywords
-2. Search existing docs with those keywords (grep 3+ terms)
-3. Decide:
-   - Overlap 70%+ -> Add to existing document
-   - Overlap 30-70% -> New doc + cross-link to existing
-   - Overlap <30% -> New document (register in Hub)
-   - Temporary info -> Journal only (no new doc)
-4. Cross-link to related docs
-5. Register in the relevant Hub
-```
-
-### Document Hygiene
-
-| Rule | Description |
-|------|-------------|
-| No orphan docs | Every document must be reachable from a Hub |
-| Hub pattern | Each folder's entry point is `{folder}.md` |
-| Prefer existing | Adding 1 doc = maintenance cost. Strengthen existing > create new |
-| Cross-link | New docs must reference at least 1 related doc |
-| Source attribution | External research must cite source and date |
-
-### Skills
-
-Roles have equipped **Skills** -- modular capability guides in `.claude/skills/`.
-
-- Role-specific skills: `.claude/skills/{role-id}/SKILL.md`
-- Shared skills: `.claude/skills/_shared/{skill-id}/SKILL.md`
-- Each Role's equipped skills are listed in `role.yaml` under `skills:`
-- **Always read SKILL.md before starting work** for that Role
-
-### Agent Dispatch Rules (CRITICAL)
-
-> **Sub-agents (Agent/Task) do NOT automatically receive CLAUDE.md.**
-> **You MUST instruct them to read CLAUDE.md in the first line of the prompt.**
-
-Without the Root (CLAUDE.md), sub-agents skip Hubs and dive straight into code,
-missing existing tools, guides, and constraints.
-
-#### Required Prompt Pattern
-
-Every sub-agent prompt **must include**:
-
-1. Instruction to read CLAUDE.md
-2. **Required skill file paths** for the Role
-
-```
-⛔ AKB Rule: Read CLAUDE.md before starting work.
-Find the relevant Hub from the "Task Routing" table and read it first.
-Check the Hub's existing tools/guides/constraints before exploring code.
-⛔ Read the required skill files below and use the tools/commands defined in them.
-```
-
-#### Role Skill Mapping
-
-| Role | Required Skills (path: `.claude/skills/{name}/SKILL.md`) |
-|------|--------------------------------------------------------|
-| Each Role | `{role-id}` + shared skills listed in `role.yaml` |
-
-> Check each Role's `role.yaml` `skills:` field for the exact list.
-
-### Self-Verification Before Escalation (CRITICAL)
-
-> **Before saying "I can't" or "user action needed", check your own tools/skills first.**
-
-#### Checklist (before reporting inability)
-
-```
-□ 1. Check CLAUDE.md routing table for relevant skills/tools
-□ 2. Glob search .claude/skills/ for related skills
-□ 3. Read the skill and determine if it can solve the problem
-□ 4. Only if all above fail → Report: "Tried X but unable due to [specific reason]"
-```
-
-### Exploration Depth
-
-> **Don't stop at Hubs. Explore detailed documents for thorough understanding.**
-
-| Question Type | Minimum | Additional |
-|--------------|---------|------------|
-| Implementation | Hub | Related Node |
-| Debugging | Hub | Related issues/logs |
-| **Strategy/Design** | Hub | **Design docs, past decisions, architecture details** |
-| **New Feature** | Hub | **Existing implementation patterns, related architecture** |
-
-### Skill Synchronization (CRITICAL)
-
-> **When changing code/processes, update related `.claude/skills/` SKILL.md files too.**
-
-| Change Type | Skill Update |
-|-------------|-------------|
-| API endpoint change | Update API reference |
-| New tool/script added | Add to tool listing |
-| Process change | Update procedure guide |
-| Feature removed | Remove related section |
-
-### AKB Management (CRITICAL)
-
-> **Every Role manages knowledge as part of their work. Don't just code and stop.**
-
-After completing any task, check:
-
-| # | Item | Description |
-|---|------|-------------|
-| 1 | **New knowledge?** | Did this task produce new insights/decisions/analysis? |
-| 2 | **Search existing docs** | Are there related docs already? (grep 3+ keywords) |
-| 3 | **Decide location** | Add to existing doc vs create new (prefer existing) |
-| 4 | **Hub connection** | Is the new/updated doc reachable from a Hub? |
-| 5 | **Cross-link** | Are there mutual references between related docs? |
-| 6 | **Task update** | Is the task status updated? Next work identified? |
-
----
-
-## Folder Structure
-
-```
-{project}/
-├── knowledge/                ← Tycono world. AI agent's cwd. Git root.
-│   ├── CLAUDE.md             ← Only AI entry point
-│   ├── .claude/skills/       ← Role skill guides
-│   │   ├── _shared/
-│   │   └── {role-id}/SKILL.md
-│   ├── roles/
-│   │   ├── roles.md          ← Hub
-│   │   └── {role-id}/
-│   │       ├── role.yaml
-│   │       ├── profile.md
-│   │       └── journal/
-│   ├── architecture/         ← Hub (technical architecture)
-│   ├── projects/             ← Hub (project tracking)
-│   ├── decisions/            ← CEO decisions
-│   ├── methodologies/        ← Frameworks & principles
-│   ├── presets/              ← Team presets
-│   ├── marketing/            ← Hub (SNS, launch, SEO)
-│   ├── e2e-experiments/      ← Hub (E2E test records)
-│   ├── company.md            ← Company info
-│   ├── custom-rules.md       ← Company custom rules (user owned)
-│   └── knowledge.md          ← Hub (domain knowledge index)
-│
-├── .tycono/                  ← Operational data (outside git)
-│   ├── config.json           ← Engine settings, codeRoots
-│   ├── tycono.db             ← SQLite (conversation history)
-│   ├── preferences.json      ← UI settings
-│   ├── waves/                ← Wave execution logs
-│   ├── sessions/             ← Session state
-│   ├── standup/              ← Daily standups
-│   ├── cost/                 ← Token cost tracking
-│   └── activity-streams/     ← SSE event logs (runtime)
-│
-└── apps/                     ← Code (default monorepo, outside git)
-```
-
----
-
-<!-- tycono:managed v{{VERSION}} — This file is managed by Tycono. Do not edit manually. -->
-<!-- Company-specific rules go in custom-rules.md (knowledge/ root) -->