tycono 0.1.27 → 0.1.29

package/bin/tycono.ts

@@ -131,13 +131,20 @@ async function startServer(): Promise<void> {
   const port = process.env.PORT ? Number(process.env.PORT) : await findFreePort();
   process.env.PORT = String(port);
 
-  // Detect company name from CLAUDE.md
+  // Detect company name from company/company.md (user-owned), fallback to CLAUDE.md
   let companyName = 'My Company';
   if (initialized) {
     try {
-      const claudeContent = fs.readFileSync(claudeMdPath, 'utf-8');
-      const titleMatch = claudeContent.match(/^#\s+(.+)/m);
-      if (titleMatch) companyName = titleMatch[1].trim();
+      const companyMdPath = path.join(process.env.COMPANY_ROOT!, 'company', 'company.md');
+      if (fs.existsSync(companyMdPath)) {
+        const companyContent = fs.readFileSync(companyMdPath, 'utf-8');
+        const titleMatch = companyContent.match(/^#\s+(.+)/m);
+        if (titleMatch) companyName = titleMatch[1].trim();
+      } else {
+        const claudeContent = fs.readFileSync(claudeMdPath, 'utf-8');
+        const titleMatch = claudeContent.match(/^#\s+(.+)/m);
+        if (titleMatch) companyName = titleMatch[1].trim();
+      }
     } catch {
       // ignore
     }

package/package.json

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

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

@@ -32,6 +32,7 @@ import { skillsRouter } from './routes/skills.js';
 import { importKnowledge } from './services/knowledge-importer.js';
 import { AnthropicProvider, type LLMProvider } from './engine/llm-adapter.js';
 import { readConfig } from './services/company-config.js';
+import { ensureClaudeMd } from './services/claude-md-manager.js';
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
@@ -102,7 +103,11 @@ function handleImportKnowledge(req: http.IncomingMessage, res: http.ServerRespon
 }
 
 export function createHttpServer(): http.Server {
-  cleanupStaleActivities();
+  // Only cleanup/ensure if a company is already initialized (avoid creating dirs in CWD)
+  if (COMPANY_ROOT && fs.existsSync(path.join(COMPANY_ROOT, 'CLAUDE.md'))) {
+    cleanupStaleActivities();
+    ensureClaudeMd(COMPANY_ROOT);
+  }
 
   const app = createExpressApp();
 
@@ -166,8 +171,9 @@ export function createExpressApp(): express.Application {
     let companyName: string | null = null;
     if (initialized) {
       try {
-        const claudeMdPath = path.join(COMPANY_ROOT, 'CLAUDE.md');
-        const content = fs.readFileSync(claudeMdPath, 'utf-8');
+        // Read company name from company/company.md (user-owned data)
+        const companyMdPath = path.join(COMPANY_ROOT, 'company', 'company.md');
+        const content = fs.readFileSync(companyMdPath, 'utf-8');
         const match = content.match(/^#\s+(.+)/m);
         if (match) companyName = match[1].trim();
       } catch { /* ignore */ }

package/src/api/src/engine/context-assembler.ts

@@ -57,10 +57,10 @@ export function assembleContext(
 
   const sections: string[] = [];
 
-  // 1. CLAUDE.md (전사 규칙 — 축약)
+  // 1. Company Rules (CLAUDE.md + custom-rules.md + company.md)
   const companyRules = loadCompanyRules(companyRoot);
   if (companyRules) {
-    sections.push('# Company Rules\n\n' + companyRules);
+    sections.push(companyRules);
   }
 
   // 2. Org Context
@@ -164,14 +164,33 @@ export function assembleContext(
 /* ─── Section Builders ───────────────────────── */
 
 function loadCompanyRules(companyRoot: string): string | null {
+  const parts: string[] = [];
+
+  // 1. System rules (CLAUDE.md — Tycono managed)
   const claudeMdPath = path.join(companyRoot, 'CLAUDE.md');
-  if (!fs.existsSync(claudeMdPath)) return null;
+  if (fs.existsSync(claudeMdPath)) {
+    parts.push(fs.readFileSync(claudeMdPath, 'utf-8'));
+  }
+
+  // 2. User custom rules (.tycono/custom-rules.md — user owned)
+  const customPath = path.join(companyRoot, '.tycono', 'custom-rules.md');
+  if (fs.existsSync(customPath)) {
+    const custom = fs.readFileSync(customPath, 'utf-8').trim();
+    if (custom) {
+      parts.push('---\n\n## Company Custom Rules\n\n' + custom);
+    }
+  }
+
+  // 3. Company info (company/company.md — user owned)
+  const companyMdPath = path.join(companyRoot, 'company', 'company.md');
+  if (fs.existsSync(companyMdPath)) {
+    const companyInfo = fs.readFileSync(companyMdPath, 'utf-8').trim();
+    if (companyInfo) {
+      parts.push('---\n\n## Company Info\n\n' + companyInfo);
+    }
+  }
 
-  // Give the full CLAUDE.md — it contains the routing table, folder structure,
-  // Hub-first principle, and other navigation info that roles need to work effectively.
-  // Previously we extracted only AKB + Git rules, but that stripped out the most
-  // practically useful parts (routing table, folder structure, skill principle).
-  return fs.readFileSync(claudeMdPath, 'utf-8');
+  return parts.length > 0 ? parts.join('\n\n') : null;
 }
 
 function buildOrgContextSection(orgTree: OrgTree, node: OrgNode): string {

package/src/api/src/engine/role-lifecycle.ts

@@ -99,9 +99,6 @@ export class RoleLifecycleManager {
 
     // 5. Update roles.md Hub
     this.addToRolesHub(def);
-
-    // 6. Update CLAUDE.md org table
-    this.addToClaudeMdOrgTable(def);
   }
 
   /**
@@ -160,8 +157,6 @@ export class RoleLifecycleManager {
 
     // Remove from roles.md Hub
     this.removeFromRolesHub(id);
-    // Remove from CLAUDE.md org table
-    this.removeFromClaudeMdOrgTable(id);
   }
 
   /**
@@ -337,25 +332,6 @@ ${def.authority.needsApproval.map((a) => `- ${a}`).join('\n')}
     fs.writeFileSync(hubPath, updatedContent);
   }
 
-  private addToClaudeMdOrgTable(def: RoleDefinition): void {
-    const claudeMdPath = path.join(this.companyRoot, 'CLAUDE.md');
-    if (!fs.existsSync(claudeMdPath)) return;
-
-    const content = fs.readFileSync(claudeMdPath, 'utf-8');
-    if (content.includes(`| **${def.name}**`)) {
-      return; // Already exists
-    }
-
-    const row = `| **${def.name}** | AI (${def.id}) | ${def.level} | ${def.reportsTo.toUpperCase()} | Active |`;
-
-    const orgSectionMatch = content.match(/## (?:조직|Organization)[\s\S]*?\n(\|[^\n]*\n)+/);
-    if (orgSectionMatch) {
-      const insertPos = (orgSectionMatch.index ?? 0) + orgSectionMatch[0].length;
-      const updated = content.slice(0, insertPos) + row + '\n' + content.slice(insertPos);
-      fs.writeFileSync(claudeMdPath, updated);
-    }
-  }
-
   private removeFromRolesHub(id: string): void {
     const hubPath = path.join(this.companyRoot, 'roles', 'roles.md');
     if (!fs.existsSync(hubPath)) return;
@@ -369,16 +345,6 @@ ${def.authority.needsApproval.map((a) => `- ${a}`).join('\n')}
     fs.writeFileSync(hubPath, lines.join('\n'));
   }
 
-  private removeFromClaudeMdOrgTable(id: string): void {
-    const claudeMdPath = path.join(this.companyRoot, 'CLAUDE.md');
-    if (!fs.existsSync(claudeMdPath)) return;
-
-    const content = fs.readFileSync(claudeMdPath, 'utf-8');
-    const lines = content.split('\n').filter((line) => {
-      return !line.includes(`(${id})`) || !line.startsWith('|');
-    });
-    fs.writeFileSync(claudeMdPath, lines.join('\n'));
-  }
 }
 
 /* ─── Helpers ──────────────────────────────── */

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

@@ -0,0 +1,93 @@
+/**
+ * claude-md-manager.ts — CLAUDE.md lifecycle management
+ *
+ * CLAUDE.md is 100% Tycono-managed. This module handles:
+ * - Version tracking via .tycono/rules-version
+ * - Auto-regeneration on version mismatch (server startup)
+ * - Backup of pre-existing CLAUDE.md (first time only)
+ * - Stub creation for .tycono/custom-rules.md
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const TEMPLATES_DIR = path.resolve(__dirname, '../../../../templates');
+
+/**
+ * Read the current package version from package.json
+ */
+function getPackageVersion(): string {
+  const pkgPath = path.resolve(__dirname, '../../../../package.json');
+  try {
+    const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
+    return pkg.version || '0.0.0';
+  } catch {
+    return '0.0.0';
+  }
+}
+
+/**
+ * Generate CLAUDE.md content from template with version marker
+ */
+function generateClaudeMd(version: string): string {
+  const tmplPath = path.join(TEMPLATES_DIR, 'CLAUDE.md.tmpl');
+  const template = fs.readFileSync(tmplPath, 'utf-8');
+  return template.replaceAll('{{VERSION}}', version);
+}
+
+/**
+ * Ensure CLAUDE.md is up-to-date with the current package version.
+ *
+ * Called on server startup. Compares .tycono/rules-version with package version.
+ * If different, regenerates CLAUDE.md from template (safe because CLAUDE.md
+ * contains 0% user data — all user customization is in .tycono/custom-rules.md).
+ */
+export function ensureClaudeMd(companyRoot: string): void {
+  const tyconoDir = path.join(companyRoot, '.tycono');
+  const rulesVersionPath = path.join(tyconoDir, 'rules-version');
+  const claudeMdPath = path.join(companyRoot, 'CLAUDE.md');
+  const customRulesPath = path.join(tyconoDir, 'custom-rules.md');
+  const backupPath = path.join(tyconoDir, 'CLAUDE.md.backup');
+
+  // Skip if not initialized (no .tycono/ directory)
+  if (!fs.existsSync(tyconoDir)) return;
+
+  const currentVersion = getPackageVersion();
+
+  // Read stored version
+  let storedVersion = '0.0.0';
+  if (fs.existsSync(rulesVersionPath)) {
+    storedVersion = fs.readFileSync(rulesVersionPath, 'utf-8').trim();
+  }
+
+  // Skip if already up-to-date
+  if (storedVersion === currentVersion) return;
+
+  // Backup existing CLAUDE.md (first time only — don't overwrite previous backup)
+  if (fs.existsSync(claudeMdPath) && !fs.existsSync(backupPath)) {
+    fs.copyFileSync(claudeMdPath, backupPath);
+    console.log(`[CLAUDE.md] Backed up existing CLAUDE.md to .tycono/CLAUDE.md.backup`);
+  }
+
+  // Regenerate CLAUDE.md from template
+  const content = generateClaudeMd(currentVersion);
+  fs.writeFileSync(claudeMdPath, content);
+
+  // Update rules-version
+  fs.writeFileSync(rulesVersionPath, currentVersion);
+
+  // Create custom-rules.md stub if not exists
+  if (!fs.existsSync(customRulesPath)) {
+    fs.writeFileSync(customRulesPath, `# Custom Rules
+
+> Company-specific rules, constraints, and processes.
+> This file is owned by you — Tycono will never overwrite it.
+
+<!-- Add your custom rules below -->
+`);
+  }
+
+  console.log(`[CLAUDE.md] System rules updated to v${currentVersion} (was v${storedVersion})`);
+}

package/src/api/src/services/scaffold.ts

@@ -13,6 +13,16 @@ const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 const TEMPLATES_DIR = path.resolve(__dirname, '../../../../templates');
 
+function getPackageVersion(): string {
+  const pkgPath = path.resolve(__dirname, '../../../../package.json');
+  try {
+    const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
+    return pkg.version || '0.0.0';
+  } catch {
+    return '0.0.0';
+  }
+}
+
 export interface ScaffoldConfig {
   companyName: string;
   description: string;
@@ -155,11 +165,23 @@ export function scaffold(config: ScaffoldConfig): string[] {
     created.push(dir + '/');
   }
 
-  // Write CLAUDE.md
+  // Write CLAUDE.md (no variable substitution — 100% Tycono managed)
   const claudeTmpl = loadTemplate('CLAUDE.md.tmpl');
-  fs.writeFileSync(path.join(root, 'CLAUDE.md'), renderTemplate(claudeTmpl, vars));
+  const pkgVersion = getPackageVersion();
+  fs.writeFileSync(path.join(root, 'CLAUDE.md'), claudeTmpl.replaceAll('{{VERSION}}', pkgVersion));
   created.push('CLAUDE.md');
 
+  // Write .tycono/rules-version
+  fs.writeFileSync(path.join(root, '.tycono', 'rules-version'), pkgVersion);
+  created.push('.tycono/rules-version');
+
+  // Write .tycono/custom-rules.md (empty stub — user owned)
+  const customRulesPath = path.join(root, '.tycono', 'custom-rules.md');
+  if (!fs.existsSync(customRulesPath)) {
+    fs.writeFileSync(customRulesPath, `# Custom Rules\n\n> Company-specific rules, constraints, and processes.\n> This file is owned by you — Tycono will never overwrite it.\n\n<!-- Add your custom rules below -->\n`);
+    created.push('.tycono/custom-rules.md');
+  }
+
   // Write company/company.md
   const companyTmpl = loadTemplate('company.md.tmpl');
   fs.writeFileSync(path.join(root, 'company', 'company.md'), renderTemplate(companyTmpl, vars));
@@ -310,16 +332,4 @@ function createRole(root: string, role: TeamRole): void {
     fs.writeFileSync(rolesHubPath, hubContent.trimEnd() + '\n' + row + '\n');
   }
 
-  // Append to CLAUDE.md org table
-  const claudeMdPath = path.join(root, 'CLAUDE.md');
-  if (fs.existsSync(claudeMdPath)) {
-    const claudeContent = fs.readFileSync(claudeMdPath, 'utf-8');
-    const orgRow = `| **${role.name}** | AI (${role.id}) | ${role.level} | ${role.reportsTo} | Active |`;
-    const orgMatch = claudeContent.match(/(## Organization[\s\S]*?\n(\|[^\n]*\n)+)/);
-    if (orgMatch) {
-      const insertPos = (orgMatch.index ?? 0) + orgMatch[0].length;
-      const updated = claudeContent.slice(0, insertPos) + orgRow + '\n' + claudeContent.slice(insertPos);
-      fs.writeFileSync(claudeMdPath, updated);
-    }
-  }
 }

package/src/api/src/services/session-store.ts

@@ -81,12 +81,18 @@ function loadAll(): void {
   }
 }
 
-// Load on startup
-loadAll();
+// Lazy load: defer until first access (avoids creating dirs in CWD before scaffold)
+let loaded = false;
+function ensureLoaded(): void {
+  if (loaded) return;
+  loaded = true;
+  loadAll();
+}
 
 /* ─── Public API ────────────────────────── */
 
 export function createSession(roleId: string, mode: 'talk' | 'do' = 'talk'): Session {
+  ensureLoaded();
   const id = `ses-${roleId}-${Date.now()}`;
   const now = new Date().toISOString();
   const session: Session = {
@@ -105,10 +111,12 @@ export function createSession(roleId: string, mode: 'talk' | 'do' = 'talk'): Ses
 }
 
 export function getSession(id: string): Session | undefined {
+  ensureLoaded();
   return cache.get(id);
 }
 
 export function listSessions(): Omit<Session, 'messages'>[] {
+  ensureLoaded();
   return Array.from(cache.values())
     .sort((a, b) => b.updatedAt.localeCompare(a.updatedAt))
     .map(({ messages: _, ...meta }) => meta);

package/templates/CLAUDE.md.tmpl

@@ -1,13 +1,6 @@
-# {{COMPANY_NAME}}
+# Company Rules
 
-> {{DESCRIPTION}}
-
----
-
-## Organization
-
-| Role | Assignee | Level | Reports To | Status |
-|------|----------|-------|------------|--------|
+> Powered by [Tycono](https://tycono.ai) — AI Company Operating Platform
 
 ---
 
@@ -40,12 +33,46 @@
 
 ## 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.**
+> ⛔ **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.
-Check the Task Routing table above to find the right Hub, then read it first.
+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 `.tycono/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
 
@@ -69,6 +96,7 @@ Check the Task Routing table above to find the right Hub, then read it first.
 |------|-------------|
 | 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 |
 
@@ -146,26 +174,35 @@ Check the Hub's existing tools/guides/constraints before exploring code.
 | Process change | Update procedure guide |
 | Feature removed | Remove related section |
 
-### Work Completion Checklist
+### AKB Management (CRITICAL)
 
-After completing any task:
+> **Every Role manages knowledge as part of their work. Don't just code and stop.**
 
-```
-1. Did this work produce new knowledge? -> Document it (Knowledge Gate)
-2. Are existing docs still accurate? -> Update if needed
-3. Is the new/updated doc reachable from a Hub? -> Add link
-4. Are there cross-links to related docs? -> Add references
-```
+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
 
 ```
-{{COMPANY_NAME}}/
-+-- CLAUDE.md                <- AI entry point
+{company}/
++-- CLAUDE.md                <- AI entry point (Tycono managed)
++-- .tycono/
+|   +-- config.json          <- Engine settings
+|   +-- preferences.json     <- UI preferences
+|   +-- custom-rules.md      <- Company custom rules (user owned)
+|   +-- rules-version        <- Current CLAUDE.md version
 +-- company/
-|   +-- company.md           <- Mission, vision
+|   +-- company.md           <- Mission, vision, company info
 +-- roles/
 |   +-- roles.md             <- Role listing (Hub)
 |   +-- {role-id}/
@@ -189,4 +226,5 @@ After completing any task:
 
 ---
 
-*Powered by [tycono](https://github.com/seongsu-kang/the-company)*
+<!-- tycono:managed v{{VERSION}} — This file is managed by Tycono. Do not edit manually. -->
+<!-- Company-specific rules go in .tycono/custom-rules.md -->