owner-clone-ai-mcp 1.84.0 → 2.1.0

package/domains/knowledge.js

@@ -162,7 +162,8 @@ text_content（自由テキスト）か、content（カテゴリ別の構造化
           description: 'カテゴリ',
           enum: ['offer', 'product', 'profile', 'testimonial', 'persona', 'sns_blog', 'ad', 'mail', 'tone', 'other', 'note_manual', 'note_research', 'note_hint', 'note_article', 'note_meeting', 'image'],
         },
-        folder_id: { type: 'string', description: 'フォルダID（省略可）' },
+        folder_id: { type: 'string', description: 'フォルダID（省略可）。プロジェクト紐付きキーで省略すると、プロジェクトの「成果物の保存先フォルダ」が設定済みなら自動でそこに保存される' },
+        subfolder: { type: 'string', description: 'プロジェクトの成果物フォルダ内のサブフォルダ名（例: "調査", "原稿"）。保存先フォルダ設定済み＋folder_id省略時のみ有効。同名があれば再利用・無ければ自動作成＝種類ごとに分かりやすく仕分けられる' },
         tags:      { type: 'array', items: { type: 'string' }, description: 'タグの配列（例: ["マーケティング", "集客"]）省略可。省略時はタグなしで登録。' },
         preserve_html_for_ai: { type: 'boolean', description: 'HTMLコードなどをプレーンテキストに変換せずAIがコード参照を可能にする。HTMLページ/コードを"成果物・中身"として保管しAIがそのまま参照・再編集できるようにする時に true（例: HTMLの納品物・コード）。false（既定）は装飾扱いでAIにはプレーンテキストで渡る。' },
       },

package/domains/projectOs.js

@@ -0,0 +1,263 @@
+'use strict';
+// プロジェクトOS — ゴール駆動のプロジェクト管理（docs/PROJECT_OS_PLAN.md §8/§14）
+// Claude Code / Codex からの利用が主役（MCPファースト）。
+// ⚠️ プロジェクト紐付きキーで接続している場合、project_id は省略可（キーから自動解決）。
+//    別プロジェクトを指定すると 403（境界はサーバーが強制する）。
+const { callApi } = require('../lib/api');
+
+const tools = [
+  {
+    name: 'get_project_os_spec',
+    description: 'プロジェクトOSの仕様書（AIの作業手順・提案の種類・進捗の規則）を取得します。プロジェクト関連の操作を始める前に一度読んでください。',
+    annotations: { readOnlyHint: true },
+    inputSchema: { type: 'object', properties: {} },
+  },
+  {
+    name: 'get_project_context',
+    description: `プロジェクトの全体像を取得します（ゴールの木・進捗・停滞/期日超過・直近の動き・リソース棚・承認待ちの提案）。
+
+■ level（トークン量の制御）:
+• brief — 木と要注意だけ（まず全体を掴む）
+• standard — 標準（既定）
+• full — 成果物・貯まったナレッジ込み
+
+作業の基本フロー: get_project_context → get_goal_briefing → 作業 → complete_task / append_project_journal`,
+    annotations: { readOnlyHint: true },
+    inputSchema: { type: 'object', properties: {
+      project_id: { type: 'string', description: 'プロジェクトID（プロジェクト紐付きキーなら省略可）' },
+      level: { type: 'string', enum: ['brief', 'standard', 'full'] },
+    } },
+  },
+  {
+    name: 'get_goal_briefing',
+    description: 'ゴール1つの「作業指示書」を取得します（祖先の文脈・完了の基準・タスク・直近の決定・棚のナレッジ本文入り）。作業を始める前に必ず読んでください。',
+    annotations: { readOnlyHint: true },
+    inputSchema: { type: 'object', properties: {
+      goal_id: { type: 'string', description: 'ゴールID（get_project_context の goal_tree から）' },
+    }, required: ['goal_id'] },
+  },
+  {
+    name: 'complete_project_task',
+    description: `タスクを完了として報告します【書き込み権限付きキーが必要】。進捗がゴールの木を上に自動伝播し、残タスクと次の一手が返ります。
+⚠️ result には「何をどう完了したか」と「done_criteria を満たした根拠」を書いてください（あとでナレッジに蒸留されます）。`,
+    annotations: { destructiveHint: false, idempotentHint: true },
+    inputSchema: { type: 'object', properties: {
+      task_id: { type: 'string' },
+      result: { type: 'string', description: '完了の内容と根拠' },
+      deliverable_refs: { type: 'array', items: { type: 'object' }, description: '成果物への参照（任意）' },
+    }, required: ['task_id'] },
+  },
+  {
+    name: 'append_project_journal',
+    description: `プロジェクトの航海日誌に記録を残します【書き込み権限付きキーが必要】。
+kind: note=メモ / decision=決定 / result=経過・実行結果 / customer=顧客の声 / metric=数値
+⚠️ 重要な進捗・判断は必ず書き残してください。日誌はあとでAIが「次も使える学び」としてナレッジに蒸留します。`,
+    annotations: { destructiveHint: false, idempotentHint: false },
+    inputSchema: { type: 'object', properties: {
+      project_id: { type: 'string', description: 'プロジェクト紐付きキーなら省略可' },
+      kind: { type: 'string', enum: ['note', 'decision', 'result', 'customer', 'metric'] },
+      title: { type: 'string' },
+      content: { type: 'string' },
+      goal_id: { type: 'string' },
+    }, required: ['kind', 'content'] },
+  },
+  {
+    name: 'propose_project_action',
+    description: `プロジェクトへの提案を登録します【書き込み権限付きキーが必要】。⚠️ 提案はユーザーの承認後に実行されます（AIが直接作らない）。
+■ kind と payload:
+• add_task — { title }
+• add_goal — { title, purpose, done_criteria }
+• create_resource — { resource_type: agent_preset|chatbot|funnel|workflow, config: { name, description } }
+⚠️ 過去に却下された提案と同じ内容は再提案しないこと（却下理由は日誌にあります）。`,
+    annotations: { destructiveHint: false, idempotentHint: true },
+    inputSchema: { type: 'object', properties: {
+      project_id: { type: 'string', description: 'プロジェクト紐付きキーなら省略可' },
+      kind: { type: 'string', enum: ['add_task', 'add_goal', 'create_resource'] },
+      payload: { type: 'object' },
+      reason: { type: 'string', description: '承認する人が一目で判断できる理由' },
+      goal_id: { type: 'string' },
+      client_token: { type: 'string', description: '冪等キー（再試行の二重登録防止）' },
+    }, required: ['kind', 'payload'] },
+  },
+  {
+    name: 'list_project_proposals',
+    description: '提案一覧を取得します（承認待ち優先・却下済みも見える）。',
+    annotations: { readOnlyHint: true },
+    inputSchema: { type: 'object', properties: { project_id: { type: 'string' } } },
+  },
+  {
+    name: 'approve_project_proposal',
+    description: '提案を承認して実行します【書き込み権限付きキーが必要】。⚠️ ユーザーから明示的に「承認して」と言われたときだけ使ってください（自分の提案を自分で承認しない）。',
+    annotations: { destructiveHint: false, idempotentHint: false },
+    inputSchema: { type: 'object', properties: { proposal_id: { type: 'string' } }, required: ['proposal_id'] },
+  },
+  {
+    name: 'reject_project_proposal',
+    description: '提案を却下します【書き込み権限付きキーが必要】。理由は日誌に残り、AIが同じ提案を繰り返さない材料になります。',
+    annotations: { destructiveHint: false, idempotentHint: true },
+    inputSchema: { type: 'object', properties: {
+      proposal_id: { type: 'string' }, reason: { type: 'string' },
+    }, required: ['proposal_id'] },
+  },
+  {
+    name: 'plan_project_goals',
+    description: 'ゴールをAIで子ゴール・タスクに分解します【書き込み権限付きキーが必要】。結果は提案として登録され、承認後に木が立ちます。',
+    annotations: { destructiveHint: false, idempotentHint: true },
+    inputSchema: { type: 'object', properties: {
+      project_id: { type: 'string', description: 'プロジェクト紐付きキーなら省略可' },
+      goal_id: { type: 'string', description: '分解対象（省略時はルートゴール）' },
+      client_token: { type: 'string' },
+    } },
+  },
+  {
+    name: 'add_project_resource',
+    description: `プロジェクトのリソース棚に載せます【書き込み権限付きキーが必要】。AIは棚に載ったものだけを見ます（境界）。
+resource_type: knowledge_item / knowledge_folder / agent_preset / chatbot / funnel / workflow / skill / slide_deck / video_project / analytics_sheet
+role: reference(参照) / tool(道具) / output(成果物)`,
+    annotations: { destructiveHint: false, idempotentHint: true },
+    inputSchema: { type: 'object', properties: {
+      project_id: { type: 'string', description: 'プロジェクト紐付きキーなら省略可' },
+      resource_type: { type: 'string' },
+      resource_id: { type: 'string' },
+      role: { type: 'string', enum: ['reference', 'tool', 'output'] },
+    }, required: ['resource_type', 'resource_id'] },
+  },
+  {
+    name: 'set_project_output_folder',
+    description: `プロジェクトの「成果物の保存先フォルダ」を設定します【書き込み権限付きキーが必要】。
+設定後は create_knowledge（folder_id未指定）がこのフォルダへ自動保存し、subfolder パラメータでサブフォルダ仕分けもできます。folder_id を省略すると解除（未分類に戻る）。`,
+    annotations: { destructiveHint: false, idempotentHint: true },
+    inputSchema: { type: 'object', properties: {
+      project_id: { type: 'string', description: 'プロジェクト紐付きキーなら省略可' },
+      folder_id: { type: 'string', description: 'ナレッジフォルダID（list_knowledge_folders で確認。省略=解除）' },
+    } },
+  },
+  {
+    name: 'distill_project_knowledge',
+    description: '航海日誌から「次も使える学び」をナレッジに整理します（蒸留）【書き込み権限付きキーが必要】。ゴール完了時は自動で走るため、ユーザーに頼まれたときだけ使ってください。',
+    annotations: { destructiveHint: false, idempotentHint: false },
+    inputSchema: { type: 'object', properties: { project_id: { type: 'string' } } },
+  },
+];
+
+const q = (args, keys) => {
+  const p = keys.filter(k => args && args[k] !== undefined && args[k] !== null)
+    .map(k => `${k}=${encodeURIComponent(args[k])}`).join('&');
+  return p ? `?${p}` : '';
+};
+
+function fmtTree(nodes, depth = 0) {
+  const lines = [];
+  for (const n of nodes || []) {
+    lines.push(`${'  '.repeat(depth)}- [${n.id}] ${n.title}（${n.status}・${n.progress_pct || 0}%）${n.done_criteria ? ` 完了基準: ${n.done_criteria}` : ''}`);
+    for (const t of n.tasks || []) lines.push(`${'  '.repeat(depth + 1)}☐ [task:${t.id}] ${t.title}（${t.status}）`);
+    lines.push(...fmtTree(n.children, depth + 1));
+  }
+  return lines;
+}
+
+const handlers = {
+  async get_project_os_spec() {
+    const d = await callApi('/project-os/spec');
+    return d.spec;
+  },
+  async get_project_context(args = {}) {
+    const d = await callApi(`/project-os/context${q(args, ['project_id', 'level'])}`);
+    const out = [`# ${d.project.name}（level: ${d.level}）`, '', '## ゴールの木', ...fmtTree(d.goal_tree)];
+    if (d.attention && (d.attention.stalled.length || d.attention.overdue.length)) {
+      out.push('', '## 要注意');
+      if (d.attention.overdue.length) out.push(`⚠ 期日超過: ${d.attention.overdue.join(' / ')}`);
+      if (d.attention.stalled.length) out.push(`⏸ 停滞: ${d.attention.stalled.join(' / ')}`);
+    }
+    if (d.pending_proposals && d.pending_proposals.length) {
+      out.push('', `## 承認待ちの提案（${d.pending_proposals.length}件）`);
+      for (const p of d.pending_proposals) out.push(`- [${p.id}] ${p.kind}: ${p.reason || ''}`);
+    }
+    if (d.resources && d.resources.length) {
+      out.push('', '## リソース棚');
+      for (const r of d.resources) out.push(`- ${r.resource_type}: ${r.name || r.resource_id}（${r.role}${r.added_by === 'ai' ? '・🤖' : ''}）`);
+    }
+    if (d.recent_journal && d.recent_journal.length) {
+      out.push('', '## 直近の動き');
+      for (const e of d.recent_journal.slice(0, 10)) out.push(`- [${e.kind}/${e.actor}] ${e.title || ''} ${e.content || ''}`.trim());
+    }
+    out.push('', `➡ ${d.guide}`);
+    return out.join('\n');
+  },
+  async get_goal_briefing(args) {
+    const d = await callApi(`/project-os/goal-briefing/${args.goal_id}`);
+    const out = [`# 作業指示書: ${d.goal.title}`, '',
+      `プロジェクト: ${d.project.name}`,
+      d.ancestors.length ? `文脈: ${d.ancestors.map(a => a.title).join(' → ')} → このゴール` : '',
+      `目的: ${d.goal.purpose || '（未記入）'}`,
+      `★完了の基準: ${d.goal.done_criteria || '（未記入）'}`,
+      `進捗: ${d.goal.progress_pct || 0}%`, ''];
+    if (d.tasks.length) {
+      out.push('## タスク');
+      for (const t of d.tasks) out.push(`${['done', 'completed'].includes(t.status) ? '☑' : '☐'} [${t.id}] ${t.title}`);
+    }
+    if (d.recent_decisions.length) {
+      out.push('', '## 直近の決定（前提にすること）');
+      for (const x of d.recent_decisions) out.push(`- ${x.title}: ${x.content || ''}`);
+    }
+    if (d.knowledge.length) {
+      out.push('', '## 棚のナレッジ（本文）');
+      for (const k of d.knowledge) out.push(`### ${k.title}（${k.category}）\n${k.body}`);
+    }
+    out.push('', `➡ ${d.guide}`);
+    return out.filter(x => x !== '').join('\n');
+  },
+  async complete_project_task(args) {
+    const d = await callApi('/project-os/complete-task', { method: 'POST', body: JSON.stringify(args) });
+    const out = [`✅ 完了: ${d.completed.title}`];
+    if (d.remaining_tasks.length) {
+      out.push('残りのタスク:');
+      for (const t of d.remaining_tasks) out.push(`☐ [${t.id}] ${t.title}`);
+    }
+    out.push(`➡ ${d.hint}`);
+    return out.join('\n');
+  },
+  async append_project_journal(args) {
+    const d = await callApi('/project-os/journal', { method: 'POST', body: JSON.stringify(args) });
+    return `✅ 日誌に記録しました（id: ${d.id}）`;
+  },
+  async propose_project_action(args) {
+    const d = await callApi('/project-os/propose', { method: 'POST', body: JSON.stringify(args) });
+    return `${d.deduped ? '♻' : '✅'} ${d.message}\n提案ID: ${d.proposal.id}`;
+  },
+  async list_project_proposals(args = {}) {
+    const d = await callApi(`/project-os/proposals${q(args, ['project_id'])}`);
+    if (!d.proposals.length) return '提案はありません。';
+    return d.proposals.map(p =>
+      `- [${p.id}] ${p.status === 'pending' ? '⏸' : p.status} ${p.kind}: ${p.reason || ''}`).join('\n');
+  },
+  async approve_project_proposal(args) {
+    const d = await callApi(`/project-os/proposals/${args.proposal_id}/approve`, { method: 'POST' });
+    return `✅ 実行しました（${d.executed}）\n結果: ${JSON.stringify(d.result)}`;
+  },
+  async reject_project_proposal(args) {
+    await callApi(`/project-os/proposals/${args.proposal_id}/reject`, { method: 'POST', body: JSON.stringify({ reason: args.reason }) });
+    return '✅ 却下しました（理由は日誌に残り、AIが同じ提案を繰り返さない材料になります）';
+  },
+  async plan_project_goals(args = {}) {
+    const d = await callApi('/project-os/plan-goals', { method: 'POST', body: JSON.stringify(args) });
+    return `${d.deduped ? '♻ 既存の提案を返します' : '✅ ' + d.message}\n提案ID: ${d.proposal.id}\n（list_project_proposals で内容確認・ユーザーの承認で実行）`;
+  },
+  async add_project_resource(args) {
+    const d = await callApi('/project-os/resources', { method: 'POST', body: JSON.stringify(args) });
+    return `✅ 棚に載せました: ${d.resource_type} ${d.resource_id}（${d.role}）`;
+  },
+  async set_project_output_folder(args = {}) {
+    const d = await callApi('/project-os/output-folder', { method: 'POST', body: JSON.stringify(args) });
+    return d.output_folder_id
+      ? `✅ 成果物の保存先を設定しました。${d.hint || ''}`
+      : '✅ 保存先を解除しました（未分類に保存されます）';
+  },
+  async distill_project_knowledge(args = {}) {
+    const d = await callApi('/project-os/distill', { method: 'POST', body: JSON.stringify(args) });
+    if (d.skipped) return `⏭ ${d.skipped}`;
+    return `✅ 学びを整理: ナレッジ${d.saved.length}件を保存\n${d.saved.map(s => `- ${s.title}（${s.category}）`).join('\n')}`;
+  },
+};
+
+module.exports = { tools, handlers };

package/domains/video.js

@@ -173,11 +173,11 @@ const tools = [
   },
   {
     name: 'patch_video_track',
-    description: '1つのトラックだけを差し替えます（タイムライン全体を送り直さなくて済むので安全・軽量）。テロップだけ直す・BGMだけ足す、といった部分更新に使ってください。',
+    description: '1つのトラックだけを差し替えます（タイムライン全体を送り直さなくて済むので安全・軽量）。テロップだけ直す・BGMだけ足す・コーナー見出し（banner）を置く、といった部分更新に使ってください。コーナー見出し＝ニュース番組の隅にあるテーマ表示で、テーマごとに start/duration を切って出しっぱなしにします（既定の位置は left 最優先の top-left）。形式は get_video_timeline_spec を参照。',
     annotations: { destructiveHint: false },
     inputSchema: { type: 'object', properties: {
       id: { type: 'string', description: 'プロジェクトID' },
-      type: { type: 'string', enum: ['slides', 'audio', 'video', 'image', 'telop'], description: '対象トラックの種類' },
+      type: { type: 'string', enum: ['slides', 'audio', 'video', 'image', 'telop', 'banner'], description: "対象トラックの種類。banner＝コーナー見出し（画面の隅に出しっぱなしの見出し。テロップとは別物）" },
       role: { type: 'string', description: '同じ種類が複数あるときの絞り込み（audio の voice / bgm）' },
       media_id: { type: 'string', description: '同じ種類が複数あるときの絞り込み（mediaId）' },
       clips: { type: 'array', items: { type: 'object' }, description: 'そのトラックのクリップ配列（全置換）。形式は get_video_timeline_spec' },

package/index.js

@@ -17,7 +17,10 @@ const workflows        = require('./domains/workflows');
 const chatbots         = require('./domains/chatbots');
 const schedulesAndTasks = require('./domains/schedulesAndTasks');
 const projects         = require('./domains/projects');
-const brain            = require('./domains/brain');
+// ⚠️ brain は 2.0.0 で配布リストから除外（プロジェクトOSに統合・docs/PROJECT_OS_PLAN.md §15）。
+//    サーバー側の /v1/brain は旧版(1.x)利用者のため読み取りシムで残っている。
+// const brain         = require('./domains/brain');
+const projectOs        = require('./domains/projectOs');
 const funnels          = require('./domains/funnels');
 const skills           = require('./domains/skills');
 const slides           = require('./domains/slides');
@@ -27,7 +30,7 @@ const myasp            = require('./domains/myasp');
 const wordpress        = require('./domains/wordpress');
 const macbuil          = require('./domains/macbuil');
 
-const allDomains = [knowledge, agentPresets, workflows, chatbots, schedulesAndTasks, projects, brain, funnels, skills, slides, video, analytics, myasp, wordpress, macbuil];
+const allDomains = [knowledge, agentPresets, workflows, chatbots, schedulesAndTasks, projects, projectOs, funnels, skills, slides, video, analytics, myasp, wordpress, macbuil];
 
 const TOOLS    = allDomains.flatMap(d => d.tools);
 const HANDLERS = Object.assign({}, ...allDomains.map(d => d.handlers));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "owner-clone-ai-mcp",
-  "version": "1.84.0",
+  "version": "2.1.0",
   "description": "MCP server for Owner Clone AI — exposes knowledge and agent presets to Claude Code",
   "main": "index.js",
   "bin": {