tycono 0.1.96-beta.3 → 0.1.96-beta.4

package/README.md

@@ -33,6 +33,50 @@ One command. Your AI company is running.
 npx tycono
 ```
 
+## Core Pillars
+
+### 1. CEO Supervisor — Org-chart orchestration
+
+You give one order. The system dispatches through a real hierarchy.
+
+```
+dispatch → watch → relay → quality gate → re-dispatch (if needed)
+```
+
+CEO delegates to C-levels, C-levels dispatch to their teams. Authority is enforced — engineers can't make CEO decisions, PMs can't merge code. The org chart isn't decoration, it's the execution engine.
+
+### 2. Observability — See everything, intervene anytime
+
+Your AI team isn't a black box. Watch every agent work in real time, inject directives mid-execution, and drill down to any level.
+
+- **Wave Center** — Org-tree dispatch with real-time streaming
+- **Activity Stream** — Every event logged (dispatches, tool calls, decisions)
+- **CEO Directive** — Change direction while agents are running
+- **Cost Tracking** — Per-role, per-model token breakdown
+
+### 3. Isolation Infrastructure — Agents don't collide
+
+Multiple agents working simultaneously without stepping on each other.
+
+| Resource | Isolation | Status |
+|----------|-----------|--------|
+| **Code** | Git worktree per session | Designed |
+| **Ports** | Dynamic port registry | ✅ Live |
+| **Browser** | Separate daemon per session | ✅ Live |
+| **Knowledge** | Shared reads, scoped writes | ✅ Live |
+
+### 4. AKB (Pre-K / Post-K) — Knowledge that compounds
+
+Every AI tool today: `Plan → Execute → Done`. Knowledge resets. Tycono adds what the industry doesn't have:
+
+```
+Pre-K:  Read existing knowledge → Plan grounded in what the company knows
+Execute: Do the work
+Post-K: Extract insights → Cross-link → Register in knowledge graph
+```
+
+Session 50 is dramatically smarter than session 1. Your company learns.
+
 ## Why Tycono?
 
 Coding agents simulate **one developer**. Tycono simulates **the entire company**.
@@ -40,11 +84,11 @@ Coding agents simulate **one developer**. Tycono simulates **the entire company*
 | | Single AI Agent | Tycono |
 |---|---|---|
 | **What it runs** | One agent, one context | Multiple roles with org hierarchy |
-| **Knowledge** | Resets every session | Compounds forever — file-based, cross-linked |
+| **Knowledge** | Resets every session | Compounds forever (AKB Pre-K/Post-K) |
 | **Authority** | Can do anything (or nothing) | Scoped — each role has clear boundaries |
 | **Delegation** | Manual prompt chaining | CEO dispatches, org chart routes automatically |
 | **Scale** | 1 agent | 7 → 700 agents |
-| **Visibility** | Terminal output | Isometric office + Slack-style Pro dashboard |
+| **Visibility** | Terminal output | Real-time org tree + activity stream |
 
 ## Company-as-Code
 
@@ -80,33 +124,46 @@ A setup wizard guides you through:
 - Node.js >= 18
 - [Anthropic API key](https://console.anthropic.com/) or Claude Max subscription
 
-## Two Ways to Work
+## Interfaces
 
-### Office View — Watch your AI team
+### Web Dashboard — Visual management
 
-An isometric pixel-art office where your AI agents sit at their desks, work, chat, and think. Click any agent to talk to them directly.
+A browser-based dashboard for visual management. Org tree, Wave dispatch, Knowledge graph, Activity stream.
 
 <p align="center">
-  <img src=".github/assets/hero-office.png" alt="Office View" width="640" />
+  <img src=".github/assets/hero-office.png" alt="Web Dashboard" width="640" />
 </p>
 
-- Pixel-art characters with personalities and levels
-- Ambient speech bubbles — agents think out loud
-- Rooms: Leadership, Engineering, Meeting, Knowledge Library
-- Edit mode — rearrange furniture, customize your office
+- **Wave Center** — selective org-tree dispatch with target checkboxes
+- **Chats** — 1:1 conversations with any role, persistent sessions
+- **Knowledge Base** — graph/tree/list views, cross-linked documents
+- **Decisions** — CEO strategic decision log with full context
 
-### Pro View — Manage your AI company
+### TUI — Terminal-native operations *(coming soon)*
 
-A Slack-style professional dashboard for serious work. Chats, Wave dispatch, Decisions log, Knowledge graph.
+For developers who live in the terminal. A k9s/lazygit-style multi-panel TUI built with [Ink](https://github.com/vadimdemedes/ink).
 
-<p align="center">
-  <img src=".github/assets/pro-view.png" alt="Pro View" width="640" />
-</p>
+```
+┌──────────────────────────────────────────────────┐
+│ TYCONO v0.2  │ Wave #37 running │ 3 active │$2.1│
+├──────────────┬───────────────────────────────────┤
+│ [Org Tree]   │ [Real-time Stream]                │
+│  CEO         │  CTO: "Reviewing architecture..." │
+│  ├ CTO ●     │    → dispatch → Engineer          │
+│  │ ├ ENG ○   │  CBO: "Market analysis done" ✓    │
+│  │ └ QA  ○   │                                   │
+│  └ CBO ●     │                                   │
+├──────────────┴───────────────────────────────────┤
+│ > wave "Write the Q1 strategy report"            │
+└──────────────────────────────────────────────────┘
+```
 
-- **Wave Center** — selective org-tree dispatch with target checkboxes
-- **Chats** — 1:1 conversations with any role, persistent sessions
-- **Knowledge Base** — graph/tree/list views, 194+ cross-linked documents
-- **Decisions** — CEO strategic decision log with full context
+```bash
+npx tycono --tui     # Terminal mode (coming soon)
+npx tycono           # Web dashboard (current)
+```
+
+Same API server, same engine — just a different frontend. Use what fits your workflow.
 
 ## Key Features
 
@@ -130,10 +187,6 @@ Every task produces knowledge. Cross-linked Markdown documents that grow with ev
 
 Each role has scoped authority defined in `role.yaml`. Engineers can't make CEO decisions. PMs can't merge code. The org chart isn't decoration — it's enforcement.
 
-### Level System
-
-Roles gain XP from completed work. Level up unlocks accessories and reflects experience. Your CTO at Lv.14 has seen things your new intern hasn't.
-
 ### Local-First, BYOK
 
 Everything runs on your machine. Your data never leaves. Bring your own Anthropic API key — no middleman, no telemetry, no tracking.
@@ -181,7 +234,8 @@ your-company/
 ## CLI Usage
 
 ```bash
-npx tycono              # Start server + open dashboard
+npx tycono              # Start server + web dashboard
+npx tycono --tui        # Terminal UI (coming soon)
 npx tycono --help       # Show help
 npx tycono --version    # Show version
 ```
@@ -194,6 +248,17 @@ npx tycono --version    # Show version
 | `PORT` | Server port | auto-detect |
 | `COMPANY_ROOT` | Company directory | current directory |
 
+## Roadmap
+
+- [x] Web dashboard (Office + Pro views)
+- [x] CEO Wave dispatch with org-tree targeting
+- [x] AKB — Pre-K / Post-K knowledge loop
+- [x] Port Registry for multi-agent isolation
+- [ ] **TUI mode** — terminal-native multi-panel interface
+- [ ] Git worktree isolation per agent session
+- [ ] Desktop app (.dmg / .exe) — background execution, system notifications
+- [ ] Multi-LLM support (OpenAI, local models)
+
 ## Built with Tycono
 
 This isn't a demo. Tycono's own landing page, documentation, and knowledge base were built by AI agents running inside Tycono. The PM wrote the PRD. The CTO reviewed architecture. The Designer created UX specs. The Engineer implemented every section.

package/bin/tycono.ts

@@ -222,7 +222,19 @@ async function startServerForTui(): Promise<void> {
     server.listen(port, host, () => resolve());
   });
 
-  console.log(`  API server started on port ${port}`);
+  // Suppress API server logs in TUI mode — redirect to file
+  const logFile = path.resolve(process.env.COMPANY_ROOT || process.cwd(), '.tycono', 'server.log');
+  try { fs.mkdirSync(path.dirname(logFile), { recursive: true }); } catch {}
+  const logStream = fs.createWriteStream(logFile, { flags: 'a' });
+  const origLog = console.log;
+  const origErr = console.error;
+  const origWarn = console.warn;
+  console.log = (...args: unknown[]) => logStream.write(args.join(' ') + '\n');
+  console.error = (...args: unknown[]) => logStream.write('[ERROR] ' + args.join(' ') + '\n');
+  console.warn = (...args: unknown[]) => logStream.write('[WARN] ' + args.join(' ') + '\n');
+
+  origLog(`  API server started on port ${port}`);
+  origLog(`  Logs: ${logFile}`);
 
   // Graceful shutdown
   const shutdown = () => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tycono",
-  "version": "0.1.96-beta.3",
+  "version": "0.1.96-beta.4",
   "description": "Build an AI company. Watch them work.",
   "type": "module",
   "bin": {

package/src/tui/api.ts

@@ -161,7 +161,7 @@ export interface TeamTemplate {
   id: string;
   name: string;
   description: string;
-  roles: string[];
+  roles: Array<string | { id: string; name: string; level?: string }>;
 }
 
 export interface ScaffoldResult {

package/src/tui/components/SetupWizard.tsx

@@ -76,11 +76,18 @@ export const SetupWizard: React.FC<SetupWizardProps> = ({ onComplete }) => {
   };
 
   const handleCodeDirSubmit = async (value: string) => {
-    const dir = value.trim() || './code';
+    const path = await import('node:path');
+    const fs = await import('node:fs');
+    const dir = path.resolve(value.trim() || './code');
     setCodeDir(dir);
     setStep('creating');
 
     try {
+      // Ensure code directory exists
+      if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+      }
+
       const result = await postSetupScaffold(companyName, selectedTeam?.id ?? 'minimal');
       setResultPath(result.path ?? '');
       setResultRoles(result.rolesCreated ?? 0);
@@ -137,7 +144,7 @@ export const SetupWizard: React.FC<SetupWizardProps> = ({ onComplete }) => {
             {teams.length > 0 ? (
               <SelectInput
                 items={teams.map((t) => ({
-                  label: `${t.id}  ${t.description || t.roles.join(', ')}`,
+                  label: `${t.id}  ${t.roles.map(r => typeof r === 'string' ? r : r.name || r.id).join(', ')}`,
                   value: t.id,
                 }))}
                 onSelect={handleTeamSelect}