tycono-server 0.1.0-beta.2 → 0.1.0-beta.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tycono-server",
-  "version": "0.1.0-beta.2",
+  "version": "0.1.0-beta.4",
   "description": "Tycono AI team orchestration server. Dispatch, supervise, and observe AI agents working as a team.",
   "type": "module",
   "bin": {

package/src/api/src/create-server.ts

@@ -101,7 +101,8 @@ export function createHttpServer(): http.Server {
   const app = createExpressApp();
 
   const server = http.createServer((req, res) => {
-    const url = req.url ?? '';
+    const rawUrl = req.url ?? '';
+    const url = rawUrl.split('?')[0]; // Strip query string for route matching
     const method = req.method ?? '';
 
     // GET /api/waves/active — restore active waves after refresh
@@ -150,8 +151,8 @@ export function createHttpServer(): http.Server {
       return;
     }
 
-    // Non-SSE exec/jobs endpoints (GET, DELETE)
-    if ((url.startsWith('/api/exec/') || url.startsWith('/api/jobs')) && (method === 'GET' || method === 'DELETE')) {
+    // Non-SSE exec/jobs/waves endpoints (GET, DELETE)
+    if ((url.startsWith('/api/exec/') || url.startsWith('/api/jobs') || url.startsWith('/api/waves/')) && (method === 'GET' || method === 'DELETE')) {
       setExecCors(req, res);
       handleExecRequest(req, res);
       return;

package/src/api/src/engine/org-tree.ts

@@ -83,6 +83,17 @@ interface RawRoleYaml {
   };
 }
 
+/* ─── Default Roles (fallback when no roles/ directory) ── */
+
+const DEFAULT_ROLES: Array<{ id: string; name: string; level: 'c-level' | 'member'; reportsTo: string; persona: string }> = [
+  { id: 'cto', name: 'CTO', level: 'c-level', reportsTo: 'ceo', persona: 'Chief Technology Officer. Leads technical architecture and manages Engineer + QA.' },
+  { id: 'cbo', name: 'CBO', level: 'c-level', reportsTo: 'ceo', persona: 'Chief Business Officer. Leads product vision and manages PM + Designer.' },
+  { id: 'engineer', name: 'Engineer', level: 'member', reportsTo: 'cto', persona: 'Software Engineer. Writes working code.' },
+  { id: 'qa', name: 'QA', level: 'member', reportsTo: 'cto', persona: 'QA Engineer. Tests and validates.' },
+  { id: 'pm', name: 'PM', level: 'member', reportsTo: 'cbo', persona: 'Product Manager. Writes specs and requirements.' },
+  { id: 'designer', name: 'Designer', level: 'member', reportsTo: 'cbo', persona: 'UI/UX Designer.' },
+];
+
 /* ─── Build ──────────────────────────────────── */
 
 export function buildOrgTree(companyRoot: string, presetId?: string): OrgTree {
@@ -167,6 +178,27 @@ export function buildOrgTree(companyRoot: string, presetId?: string): OrgTree {
     }
   }
 
+  // Fallback: if no C-Level roles found, use built-in defaults
+  const hasCLevel = Array.from(tree.nodes.values()).some(
+    n => n.id !== 'ceo' && n.level === 'c-level'
+  );
+  if (!hasCLevel) {
+    for (const def of DEFAULT_ROLES) {
+      if (tree.nodes.has(def.id)) continue;
+      tree.nodes.set(def.id, {
+        id: def.id,
+        name: def.name,
+        level: def.level,
+        reportsTo: def.reportsTo,
+        children: [],
+        persona: def.persona,
+        authority: { autonomous: [], needsApproval: [] },
+        knowledge: { reads: [], writes: [] },
+        reports: { daily: '', weekly: '' },
+      });
+    }
+  }
+
   // Wire up children from reportsTo
   for (const [id, node] of tree.nodes) {
     if (id === 'ceo') continue;

package/src/api/src/routes/execute.ts

@@ -126,6 +126,32 @@ export function handleExecRequest(req: IncomingMessage, res: ServerResponse): vo
     return;
   }
 
+  // ── GET /api/waves/:waveId — Single wave status ──
+  const waveDetailMatch = url.match(/^\/api\/waves\/([^/]+)$/);
+  if (method === 'GET' && waveDetailMatch) {
+    const waveId = waveDetailMatch[1];
+    // Try active waves first
+    const activeWaves = waveMultiplexer.getActiveWaves();
+    const active = activeWaves.find((w: { waveId: string }) => w.waveId === waveId);
+    if (active) {
+      jsonResponse(res, 200, active);
+      return;
+    }
+    // Fallback: read wave file from disk
+    const wavePath = path.join(COMPANY_ROOT, '.tycono', 'waves', `${waveId}.json`);
+    if (fs.existsSync(wavePath)) {
+      try {
+        const waveData = JSON.parse(fs.readFileSync(wavePath, 'utf-8'));
+        jsonResponse(res, 200, waveData);
+      } catch {
+        jsonResponse(res, 500, { error: 'Failed to read wave file' });
+      }
+      return;
+    }
+    jsonResponse(res, 404, { error: 'Wave not found' });
+    return;
+  }
+
   // ── Legacy /api/exec/* routes ──
   const sessionMatch = url.match(/\/api\/exec\/session\/([^/]+)\/message$/);
 

package/src/api/src/services/claude-md-manager.ts

@@ -66,6 +66,16 @@ export function ensureClaudeMd(companyRoot: string): void {
   // Skip if already up-to-date
   if (storedVersion === currentVersion) return;
 
+  // Plugin mode: if CLAUDE.md exists but has no tycono:managed marker, don't touch it.
+  // This means the user (or plugin scaffold) owns CLAUDE.md — server should not overwrite.
+  if (fs.existsSync(claudeMdPath)) {
+    const existing = fs.readFileSync(claudeMdPath, 'utf-8');
+    if (!existing.includes('tycono:managed')) {
+      console.log(`[CLAUDE.md] Skipping — existing CLAUDE.md is not Tycono-managed`);
+      return;
+    }
+  }
+
   // Backup existing CLAUDE.md (first time only — don't overwrite previous backup)
   if (fs.existsSync(claudeMdPath) && !fs.existsSync(backupPath)) {
     fs.copyFileSync(claudeMdPath, backupPath);

package/src/api/src/services/wave-multiplexer.ts

@@ -300,14 +300,14 @@ class WaveMultiplexer {
   getActiveWaves(): Array<{
     id: string;
     directive: string;
-    dispatches: Array<{ sessionId: string; roleId: string; roleName: string }>;
+    dispatches: Array<{ sessionId: string; roleId: string; roleName: string; status: string }>;
     startedAt: number;
     sessionIds: string[];
   }> {
     const result: Array<{
       id: string;
       directive: string;
-      dispatches: Array<{ sessionId: string; roleId: string; roleName: string }>;
+      dispatches: Array<{ sessionId: string; roleId: string; roleName: string; status: string }>;
       startedAt: number;
       sessionIds: string[];
     }> = [];
@@ -316,12 +316,13 @@ class WaveMultiplexer {
       const hasActive = Array.from(sessions.values()).some(e => e.status === 'running' || e.status === 'awaiting_input');
       if (!hasActive) continue;
 
+      // Include ALL sessions (not just root) so plugin can show full team status
       const rootSessions = Array.from(sessions.values())
-        .filter(e => !e.parentSessionId || !sessions.has(e.parentSessionId))
         .map(e => ({
           sessionId: e.sessionId,
           roleId: e.roleId,
           roleName: e.roleId.toUpperCase(),
+          status: e.status,
         }));
 
       const firstExec = rootSessions.length > 0

package/templates/CLAUDE.md.tmpl

@@ -1,237 +1,150 @@
-# Company Rules
+# Your Knowledge Base
 
-> Powered by [Tycono](https://tycono.ai) — AI Company Operating Platform
+> Powered by [Tycono](https://tycono.ai)
 
 ---
 
-## Task Routing
+## AKB Core Concept
 
-| 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`
+> **AKB** = File-based knowledge system where AI finds via **Search (Grep/Glob)** and navigates via **Contextual Links**
 
 | 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 |
+| **Hub** ({folder}.md) | Human TOC + guides | **Check before starting work** |
+| **Node** (*.md) | Actual information | Direct search 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 ⑤.
+## AI Working Rules (CRITICAL)
 
 ### Hub-First Principle
 
-> ⛔ **Read the relevant Hub document before starting any work.**
+> ⛔ **Read Hub document BEFORE implementing/testing**
+
+Based on AKB observations, AI tends to skip Hubs and search directly.
+But **Hubs contain existing tools/scripts/guides** - missing them causes redundant 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
+### Required Check Situations
 
-> ⛔ **If `.claude/skills/{role-id}/SKILL.md` exists, you MUST read it.**
+| Situation | Read First | What to Find |
+|-----------|------------|--------------|
+| Debugging/Testing | Hub → guides/ | Existing debug tools |
+| API Calls | Hub → related Node | Documented methods |
+| New Feature | Hub | Similar existing features |
+| Strategy/Design | Hub + detail docs | Design philosophy, past decisions |
 
-Skill files define the tools, commands, and guides for each Role.
-Working without reading skills means missing existing tools and starting from scratch.
+### Correct Patterns
 
-### 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
+```
+✅ Debugging
+   → {domain}.md (Hub) → guides/debugging.md
+   → Use existing debug scripts
 
-- Source code changes: feature branch → PR → merge
-- Direct push to main is prohibited
+✅ Testing
+   → {domain}.md (Hub) → test utilities
 
-### Knowledge Gate
+✅ API Integration
+   → api.md (Hub) → existing client libraries
+```
 
-> **Before creating a new document, search existing docs first.**
+### Anti-Patterns
 
 ```
-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
+❌ Skip Hub → curl API directly
+❌ Skip Hub → Write scripts from scratch
+❌ Skip Hub → Start with assumptions
 ```
 
-### 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)
+## Exploration Depth Principle
 
-> **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.**
+> ⛔ **For strategy/idea questions, Hub alone is NOT enough. Explore detail docs.**
 
-Without the Root (CLAUDE.md), sub-agents skip Hubs and dive straight into code,
-missing existing tools, guides, and constraints.
+AI tends to read a few Hubs and judge "sufficient".
+But **strategic questions need specific context** - shallow exploration leads to superficial answers.
 
-#### Required Prompt Pattern
+### Exploration Depth by Question Type
 
-Every sub-agent prompt **must include**:
+| Question Type | Minimum | Additional |
+|---------------|---------|------------|
+| Implementation | Hub | Related Nodes |
+| Debugging/Testing | Hub → guides/ | Existing tools |
+| **Strategy/Ideas** | Hub | **Design philosophy, core problems, phase docs** |
+| **Connecting A and B** | **Both Hubs** | **Both core docs (design, business, phases)** |
 
-1. Instruction to read CLAUDE.md
-2. **Required skill file paths** for the Role
+### When Deep Exploration is Needed
 
 ```
-⛔ 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.
+✅ "How to connect System A and System B?"
+   → system-a.md + system-b.md (both Hubs)
+   → architecture.md (system design)
+   → security-model.md (design philosophy)
+   → business-requirements.md (business context)
+
+✅ "Ideas for improving performance?"
+   → {domain}.md (Hub)
+   → performance-analysis.md (problem details, current approach)
+
+✅ "Apply this architecture to another domain?"
+   → architecture.md (Hub)
+   → design-philosophy.md (domain-independent principles)
 ```
 
-#### 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)
+### Risks of Shallow Exploration
 
 ```
-□ 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]"
+❌ Read only a few Hubs → "sufficient" judgment → superficial ideas
+❌ List only technical features → No connection to actual problems
+❌ Deep dive one side only → Forced fitting (bad integration)
 ```
 
-### Exploration Depth
+> **Domain ≠ Core Problem**
+> Knowing "what the service is" but not "what's the core problem" → Technology pushing happens.
+> AKB Hubs specify core problems, enabling "problem-centered" connections.
 
-> **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.**
+## Knowledge Gate
 
-| 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 |
+> **Before creating a new document, search existing docs first.**
 
-### AKB Management (CRITICAL)
+```
+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
+```
 
-> **Every Role manages knowledge as part of their work. Don't just code and stop.**
+---
 
-After completing any task, check:
+## Document Hygiene
 
-| # | 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? |
+| 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 |
 
 ---
 
-## Folder Structure
+## Writing Rules (4 Principles)
 
-```
-{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)
-```
+1. **TL;DR Required**: Include searchable keywords (bold)
+2. **Contextual Links**: Place links in body text with context
+3. **Keyword-Optimized Filenames**: `wallet-security.md` not `security.md`
+4. **Atomicity**: One topic per document, under 200 lines
 
 ---