@lucapimenta/copy-chief-black 1.0.0

package/framework/scripts/statusline.sh

@@ -0,0 +1,221 @@
+#!/usr/bin/env bash
+# ~/.claude/scripts/statusline.sh
+# Claude Code statusLine — Copy Chief BLACK
+# v8.0 - PERSISTENT SOURCES ONLY (BSSF S4: zero volatile dependency)
+#
+# Sources (priority order):
+#   1. helix-state.yaml  (persistent, per offer — field: phase or workflow_phase)
+#   2. project_state.yaml (persistent, per offer — field: current_phase or phase)
+#   3. cwd walk-up detection (filesystem)
+#
+# Format: [PERSONA] offer | PHASE | ctx% | cwd (branch)
+# Fallback (no offer detected): cwd (branch) | ctx% | model
+
+input=$(cat)
+
+# Extract fields from JSON input
+cwd=$(echo "$input" | jq -r '.cwd // .workspace.current_dir // empty')
+model=$(echo "$input" | jq -r '.model.display_name // empty')
+used_pct=$(echo "$input" | jq -r '.context_window.used_percentage // empty')
+vim_mode=$(echo "$input" | jq -r '.vim.mode // empty')
+session_name=$(echo "$input" | jq -r '.session_name // empty')
+
+ECOSYSTEM_ROOT="$HOME/copywriting-ecosystem"
+
+persona=""
+offer_name=""
+phase_label=""
+
+# ─── Phase -> Persona mapping ───────────────────────────────────────────
+map_phase_to_persona() {
+  case "$(echo "$1" | tr '[:lower:]' '[:upper:]')" in
+    RESEARCH)   echo "VOX" ;;
+    BRIEFING)   echo "ATLAS" ;;
+    PRODUCTION) echo "BLADE" ;;
+    REVIEW)     echo "HAWK" ;;
+    DELIVERED)  echo "HELIX" ;;
+    SETUP)      echo "HELIX" ;;
+    IDLE)       echo "HELIX" ;;
+    *)          echo "HELIX" ;;
+  esac
+}
+
+# ─── Detect offer from cwd (walk up to find helix-state.yaml) ───────────
+detect_from_cwd() {
+  local check_dir="${1:-$cwd}"
+  [ -z "$check_dir" ] && return
+
+  while [ "$check_dir" != "/" ] && [ "$check_dir" != "$HOME" ]; do
+    if [ -f "$check_dir/helix-state.yaml" ]; then
+      # Extract phase: try 'phase' first, then 'workflow_phase'
+      local detected_phase
+      detected_phase=$(grep -E '^\s*phase\s*:' "$check_dir/helix-state.yaml" 2>/dev/null | head -1 | sed 's/#.*//' | sed 's/.*:\s*//' | tr -d "\"' " | xargs | tr '[:lower:]' '[:upper:]')
+      if [ -z "$detected_phase" ] || [ "$detected_phase" = "NULL" ]; then
+        detected_phase=$(grep -E '^\s*workflow_phase\s*:' "$check_dir/helix-state.yaml" 2>/dev/null | head -1 | sed 's/#.*//' | sed 's/.*:\s*//' | tr -d "\"' " | xargs | tr '[:lower:]' '[:upper:]')
+      fi
+
+      if [ -n "$detected_phase" ] && [ "$detected_phase" != "NULL" ]; then
+        phase_label="$detected_phase"
+      fi
+
+      # Extract offer name: use offer_path if available, else directory name
+      local offer_path
+      offer_path=$(grep -E '^\s*offer_path\s*:' "$check_dir/helix-state.yaml" 2>/dev/null | head -1 | sed 's/#.*//' | sed 's/.*:\s*//' | tr -d "\"' " | xargs)
+      if [ -n "$offer_path" ] && [ "$offer_path" != "null" ]; then
+        offer_name="$offer_path"
+      else
+        # Derive from path relative to ecosystem root
+        offer_name="${check_dir#$ECOSYSTEM_ROOT/}"
+      fi
+      return 0
+    fi
+    check_dir=$(dirname "$check_dir")
+  done
+  return 1
+}
+
+# ─── Detect offer by finding most recently updated helix-state.yaml ──────
+detect_most_recent_offer() {
+  local latest_file
+  latest_file=$(find "$ECOSYSTEM_ROOT" -name "helix-state.yaml" \
+    -not -path "*/.git/*" \
+    -not -path "*/.claude/*" \
+    -not -path "*/node_modules/*" \
+    -not -path "*/templates/*" \
+    -not -path "*/lucapimenta/*" \
+    -not -path "*/tool-results/*" \
+    -newer "$ECOSYSTEM_ROOT" \
+    -type f 2>/dev/null | while read -r f; do
+      echo "$(stat -f '%m' "$f" 2>/dev/null || stat -c '%Y' "$f" 2>/dev/null) $f"
+    done | sort -rn | head -1 | awk '{print $2}')
+
+  if [ -n "$latest_file" ]; then
+    local offer_dir
+    offer_dir=$(dirname "$latest_file")
+    detect_from_cwd "$offer_dir"
+    return $?
+  fi
+  return 1
+}
+
+# ─── Enrich phase from project_state.yaml if missing ────────────────────
+enrich_from_project_state() {
+  local offer_dir="$ECOSYSTEM_ROOT/$offer_name"
+  [ ! -f "$offer_dir/project_state.yaml" ] && return
+
+  if [ -z "$phase_label" ] || [ "$phase_label" = "IDLE" ]; then
+    local ps_phase
+    ps_phase=$(grep -E '^\s*current_phase\s*:' "$offer_dir/project_state.yaml" 2>/dev/null | head -1 | sed 's/.*:\s*//' | tr -d "\"' " | tr '[:lower:]' '[:upper:]')
+    if [ -z "$ps_phase" ] || [ "$ps_phase" = "NULL" ]; then
+      ps_phase=$(grep -E '^\s*phase\s*:' "$offer_dir/project_state.yaml" 2>/dev/null | head -1 | sed 's/.*:\s*//' | tr -d "\"' " | tr '[:lower:]' '[:upper:]')
+    fi
+    if [ -n "$ps_phase" ] && [ "$ps_phase" != "NULL" ]; then
+      phase_label="$ps_phase"
+    fi
+  fi
+}
+
+# ─── Detection chain (persistent only) ──────────────────────────────────
+
+# 1. Try cwd walk-up (most accurate — user is IN the offer directory)
+if [ -n "$cwd" ]; then
+  detect_from_cwd "$cwd"
+fi
+
+# 2. If no offer found, find most recently updated offer
+if [ -z "$offer_name" ]; then
+  detect_most_recent_offer
+fi
+
+# 3. Enrich phase from project_state.yaml
+if [ -n "$offer_name" ]; then
+  enrich_from_project_state
+fi
+
+# 4. Map phase to persona
+if [ -n "$phase_label" ]; then
+  persona=$(map_phase_to_persona "$phase_label")
+fi
+
+# ─── Display helpers ─────────────────────────────────────────────────────
+
+# Shorten offer name: just the last segment (offer name, not full path)
+short_offer=""
+if [ -n "$offer_name" ]; then
+  short_offer=$(basename "$offer_name")
+fi
+
+# Shorten cwd: replace $HOME with ~
+if [ -n "$cwd" ]; then
+  short_cwd="${cwd/#$HOME/~}"
+else
+  short_cwd="~"
+fi
+
+# Git branch (non-blocking)
+git_branch=""
+target_dir="${cwd:-$HOME}"
+if git -C "$target_dir" rev-parse --git-dir >/dev/null 2>&1; then
+  branch=$(GIT_OPTIONAL_LOCKS=0 git -C "$target_dir" symbolic-ref --short HEAD 2>/dev/null)
+  if [ -n "$branch" ]; then
+    git_branch=" ($branch)"
+  fi
+fi
+
+# Context percentage
+ctx_indicator=""
+if [ -n "$used_pct" ] && [ "$used_pct" != "null" ]; then
+  used_int=$(printf "%.0f" "$used_pct" 2>/dev/null || echo "0")
+  ctx_indicator="${used_int}% ctx"
+fi
+
+# Model short name
+model_short=""
+if [ -n "$model" ] && [ "$model" != "null" ]; then
+  model_short="$model"
+fi
+
+# Vim mode
+vim_indicator=""
+if [ -n "$vim_mode" ] && [ "$vim_mode" != "null" ]; then
+  vim_indicator="$vim_mode"
+fi
+
+# Session name
+session_indicator=""
+if [ -n "$session_name" ] && [ "$session_name" != "null" ]; then
+  session_indicator="$session_name"
+fi
+
+# ─── Compose final status line ──────────────────────────────────────────
+
+if [ -n "$persona" ] && [ -n "$short_offer" ]; then
+  # AIOS mode: [PERSONA] offer | PHASE | ctx% | cwd (branch)
+  parts="[${persona}] ${short_offer} | ${phase_label}"
+
+  if [ -n "$ctx_indicator" ]; then
+    parts="${parts} | ${ctx_indicator}"
+  fi
+
+  parts="${parts} | ${short_cwd}${git_branch}"
+
+  printf "%s" "$parts"
+else
+  # Fallback: cwd (branch) | ctx% | model
+  parts="${short_cwd}${git_branch}"
+
+  if [ -n "$ctx_indicator" ]; then
+    parts="${parts} | ${ctx_indicator}"
+  fi
+  if [ -n "$model_short" ]; then
+    parts="${parts} | ${model_short}"
+  fi
+  if [ -n "$vim_indicator" ]; then
+    parts="${parts} | ${vim_indicator}"
+  fi
+  if [ -n "$session_indicator" ]; then
+    parts="${parts} | ${session_indicator}"
+  fi
+
+  printf "%s" "$parts"
+fi

package/framework/scripts/sync-ide.js

@@ -0,0 +1,142 @@
+'use strict';
+
+/**
+ * Multi-IDE Sync (U-35)
+ *
+ * Converts canonical agent .md files to IDE-specific format.
+ * Generates .cursor/rules/ and .gemini/rules/ from agents/*.md.
+ * On-demand only — not wired to session hooks.
+ *
+ * Usage: node ~/.claude/scripts/sync-ide.js [cursor|gemini|all] [outputDir]
+ *
+ * @module sync-ide
+ * @version 1.0.0
+ * @atom U-35
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+const AGENTS_DIR = path.join(process.env.HOME, '.claude', 'agents');
+const DEFAULT_OUTPUT = path.join(process.env.HOME, 'copywriting-ecosystem');
+
+/**
+ * IDE adapter definitions.
+ */
+const ADAPTERS = {
+  cursor: {
+    dir: '.cursor/rules',
+    ext: '.mdc',
+    transform: cursorTransform,
+  },
+  gemini: {
+    dir: '.gemini/rules',
+    ext: '.md',
+    transform: geminiTransform,
+  },
+};
+
+/**
+ * Sync agents to IDE format.
+ *
+ * @param {object} options
+ * @param {string} [options.target='all'] - Target IDE: 'cursor', 'gemini', or 'all'
+ * @param {string} [options.outputDir] - Output base directory
+ * @returns {{ filesGenerated: number, targets: string[] }}
+ */
+function syncIDE(options = {}) {
+  const target = options.target || 'all';
+  const outputDir = options.outputDir || DEFAULT_OUTPUT;
+  let filesGenerated = 0;
+  const targets = [];
+
+  // Load agent files
+  const agentFiles = loadAgentFiles();
+
+  const adaptersToRun = target === 'all'
+    ? Object.keys(ADAPTERS)
+    : [target];
+
+  for (const adapterName of adaptersToRun) {
+    const adapter = ADAPTERS[adapterName];
+    if (!adapter) continue;
+
+    const rulesDir = path.join(outputDir, adapter.dir);
+    fs.mkdirSync(rulesDir, { recursive: true });
+
+    for (const agent of agentFiles) {
+      const content = adapter.transform(agent);
+      const filePath = path.join(rulesDir, `${agent.id}${adapter.ext}`);
+      fs.writeFileSync(filePath, content, 'utf8');
+      filesGenerated++;
+    }
+
+    targets.push(adapterName);
+  }
+
+  return { filesGenerated, targets };
+}
+
+/**
+ * Load all agent .md files.
+ */
+function loadAgentFiles() {
+  const agents = [];
+
+  try {
+    const files = fs.readdirSync(AGENTS_DIR).filter(f =>
+      f.endsWith('.md') && !f.startsWith('.')
+    );
+
+    for (const file of files) {
+      const content = fs.readFileSync(path.join(AGENTS_DIR, file), 'utf8');
+      const id = file.replace('.md', '');
+
+      // Parse frontmatter
+      const fmMatch = content.match(/^---\n([\s\S]*?)\n---/);
+      const body = fmMatch ? content.slice(fmMatch[0].length).trim() : content;
+
+      agents.push({ id, file, content, body, frontmatter: fmMatch ? fmMatch[1] : '' });
+    }
+  } catch { /* empty */ }
+
+  return agents;
+}
+
+/**
+ * Transform agent to Cursor .mdc format.
+ */
+function cursorTransform(agent) {
+  return [
+    '---',
+    `description: ${agent.id} agent rules`,
+    'globs:',
+    `alwaysApply: false`,
+    '---',
+    '',
+    `# ${agent.id.charAt(0).toUpperCase() + agent.id.slice(1)} Agent`,
+    '',
+    agent.body,
+  ].join('\n');
+}
+
+/**
+ * Transform agent to Gemini .md format.
+ */
+function geminiTransform(agent) {
+  return [
+    `# ${agent.id.charAt(0).toUpperCase() + agent.id.slice(1)} Agent`,
+    '',
+    agent.body,
+  ].join('\n');
+}
+
+// CLI entry point
+if (require.main === module) {
+  const target = process.argv[2] || 'all';
+  const outputDir = process.argv[3] || DEFAULT_OUTPUT;
+  const result = syncIDE({ target, outputDir });
+  console.log(`Synced ${result.filesGenerated} files for: ${result.targets.join(', ')}`);
+}
+
+module.exports = { syncIDE, ADAPTERS };

package/framework/skills/.serena/memories/aios-exploration-plan.md

@@ -0,0 +1,64 @@
+# AIOS Ecosystem Exhaustive Exploration Plan
+
+## Objective
+Complete VERY THOROUGH, exhaustive exploration of AIOS/Synkra repositories to identify ALL remaining features not yet documented.
+
+## Scope
+7 primary repositories identified:
+1. ~/aios-squads/
+2. ~/mcp-ecosystem/
+3. ~/aios-core/
+4. ~/aios-dashboard/
+5. ~/facebook-ads-library-mcp/
+6. ~/.zen-mcp-server/
+7. ~/.claude-squad/
+
+## Already Documented Features
+- ETL Squad v2.0.0: blog collection, speaker diarization, data validation
+- Creator Squad v1.0.0: expansion pack creation, agent/task/template generation
+- MCP ecosystem: 6 MCPs (assemblyai, youtube-transcript, pdf-reader, web-fetch, apify, brave-search)
+- Core framework documented in README
+
+## INCOMPLETE - To Be Extracted
+
+### Phase 1: Complete File Inventories
+- [ ] Generate complete file listing for ~/aios-squads/ (229 files, needs detail breakdown)
+- [ ] Generate complete file listing for ~/mcp-ecosystem/
+- [ ] Generate complete file listing for ~/aios-core/ (extensive, need full map)
+- [ ] Generate complete file listing for ~/aios-dashboard/
+- [ ] Generate complete file listing for ~/facebook-ads-library-mcp/
+- [ ] Generate complete file listing for ~/.zen-mcp-server/
+- [ ] Generate complete file listing for ~/.claude-squad/
+
+### Phase 2: Detailed Feature Extraction
+- [ ] Read ALL agent definitions (agents/*.md)
+- [ ] Read ALL task definitions (tasks/*.md)
+- [ ] Read ALL templates (templates/*.yaml or templates/*.md)
+- [ ] Read ALL data files (data/*.md or data/*.yaml)
+- [ ] Read ALL checklists (checklists/*.md)
+- [ ] Read ALL configuration files (config/*.yaml, config/*.json)
+- [ ] Read ALL scripts (scripts/ and bin/ directories)
+- [ ] Read ALL remaining README files not yet examined
+
+### Phase 3: Cross-Repository Analysis
+- [ ] Create feature matrix: which features in which repos
+- [ ] Identify deprecated components
+- [ ] Map workflow dependencies
+- [ ] Document all MCP integrations
+- [ ] Identify hidden agents/tasks
+
+### Phase 4: Compilation
+- [ ] Create comprehensive feature inventory
+- [ ] Document unique patterns discovered
+- [ ] Create cross-repository dependency map
+- [ ] Final summary of all discoveries
+
+## Strategy
+Use combination of:
+- `find` for complete file listings
+- `Glob` for pattern matching
+- `Read` for key files
+- `Grep` for searching specific patterns
+
+## Status: READY TO EXECUTE
+Awaiting user approval to proceed with execution.

package/framework/skills/.serena/project.yml

@@ -0,0 +1,121 @@
+# list of languages for which language servers are started; choose from:
+#   al                  bash                clojure             cpp                 csharp
+#   csharp_omnisharp    dart                elixir              elm                 erlang
+#   fortran             fsharp              go                  groovy              haskell
+#   java                julia               kotlin              lua                 markdown
+#   matlab              nix                 pascal              perl                php
+#   powershell          python              python_jedi         r                   rego
+#   ruby                ruby_solargraph     rust                scala               swift
+#   terraform           toml                typescript          typescript_vts      vue
+#   yaml                zig
+#   (This list may be outdated. For the current list, see values of Language enum here:
+#   https://github.com/oraios/serena/blob/main/src/solidlsp/ls_config.py
+#   For some languages, there are alternative language servers, e.g. csharp_omnisharp, ruby_solargraph.)
+# Note:
+#   - For C, use cpp
+#   - For JavaScript, use typescript
+#   - For Free Pascal/Lazarus, use pascal
+# Special requirements:
+#   - csharp: Requires the presence of a .sln file in the project folder.
+#   - pascal: Requires Free Pascal Compiler (fpc) and optionally Lazarus.
+# When using multiple languages, the first language server that supports a given file will be used for that file.
+# The first language is the default language and the respective language server will be used as a fallback.
+# Note that when using the JetBrains backend, language servers are not used and this list is correspondingly ignored.
+languages:
+- python
+
+# the encoding used by text files in the project
+# For a list of possible encodings, see https://docs.python.org/3.11/library/codecs.html#standard-encodings
+encoding: "utf-8"
+
+# whether to use project's .gitignore files to ignore files
+ignore_all_files_in_gitignore: true
+
+# list of additional paths to ignore in all projects
+# same syntax as gitignore, so you can use * and **
+ignored_paths: []
+
+# whether the project is in read-only mode
+# If set to true, all editing tools will be disabled and attempts to use them will result in an error
+# Added on 2025-04-18
+read_only: false
+
+# list of tool names to exclude. We recommend not excluding any tools, see the readme for more details.
+# Below is the complete list of tools for convenience.
+# To make sure you have the latest list of tools, and to view their descriptions, 
+# execute `uv run scripts/print_tool_overview.py`.
+#
+#  * `activate_project`: Activates a project by name.
+#  * `check_onboarding_performed`: Checks whether project onboarding was already performed.
+#  * `create_text_file`: Creates/overwrites a file in the project directory.
+#  * `delete_lines`: Deletes a range of lines within a file.
+#  * `delete_memory`: Deletes a memory from Serena's project-specific memory store.
+#  * `execute_shell_command`: Executes a shell command.
+#  * `find_referencing_code_snippets`: Finds code snippets in which the symbol at the given location is referenced.
+#  * `find_referencing_symbols`: Finds symbols that reference the symbol at the given location (optionally filtered by type).
+#  * `find_symbol`: Performs a global (or local) search for symbols with/containing a given name/substring (optionally filtered by type).
+#  * `get_current_config`: Prints the current configuration of the agent, including the active and available projects, tools, contexts, and modes.
+#  * `get_symbols_overview`: Gets an overview of the top-level symbols defined in a given file.
+#  * `initial_instructions`: Gets the initial instructions for the current project.
+#     Should only be used in settings where the system prompt cannot be set,
+#     e.g. in clients you have no control over, like Claude Desktop.
+#  * `insert_after_symbol`: Inserts content after the end of the definition of a given symbol.
+#  * `insert_at_line`: Inserts content at a given line in a file.
+#  * `insert_before_symbol`: Inserts content before the beginning of the definition of a given symbol.
+#  * `list_dir`: Lists files and directories in the given directory (optionally with recursion).
+#  * `list_memories`: Lists memories in Serena's project-specific memory store.
+#  * `onboarding`: Performs onboarding (identifying the project structure and essential tasks, e.g. for testing or building).
+#  * `prepare_for_new_conversation`: Provides instructions for preparing for a new conversation (in order to continue with the necessary context).
+#  * `read_file`: Reads a file within the project directory.
+#  * `read_memory`: Reads the memory with the given name from Serena's project-specific memory store.
+#  * `remove_project`: Removes a project from the Serena configuration.
+#  * `replace_lines`: Replaces a range of lines within a file with new content.
+#  * `replace_symbol_body`: Replaces the full definition of a symbol.
+#  * `restart_language_server`: Restarts the language server, may be necessary when edits not through Serena happen.
+#  * `search_for_pattern`: Performs a search for a pattern in the project.
+#  * `summarize_changes`: Provides instructions for summarizing the changes made to the codebase.
+#  * `switch_modes`: Activates modes by providing a list of their names
+#  * `think_about_collected_information`: Thinking tool for pondering the completeness of collected information.
+#  * `think_about_task_adherence`: Thinking tool for determining whether the agent is still on track with the current task.
+#  * `think_about_whether_you_are_done`: Thinking tool for determining whether the task is truly completed.
+#  * `write_memory`: Writes a named memory (for future reference) to Serena's project-specific memory store.
+excluded_tools: []
+
+# initial prompt for the project. It will always be given to the LLM upon activating the project
+# (contrary to the memories, which are loaded on demand).
+initial_prompt: ""
+# the name by which the project can be referenced within Serena
+project_name: "skills"
+
+# list of tools to include that would otherwise be disabled (particularly optional tools that are disabled by default)
+included_optional_tools: []
+
+# list of mode names to that are always to be included in the set of active modes
+# The full set of modes to be activated is base_modes + default_modes.
+# If the setting is undefined, the base_modes from the global configuration (serena_config.yml) apply.
+# Otherwise, this setting overrides the global configuration.
+# Set this to [] to disable base modes for this project.
+# Set this to a list of mode names to always include the respective modes for this project.
+base_modes:
+
+# list of mode names that are to be activated by default.
+# The full set of modes to be activated is base_modes + default_modes.
+# If the setting is undefined, the default_modes from the global configuration (serena_config.yml) apply.
+# Otherwise, this overrides the setting from the global configuration (serena_config.yml).
+# This setting can, in turn, be overridden by CLI parameters (--mode).
+default_modes:
+
+# fixed set of tools to use as the base tool set (if non-empty), replacing Serena's default set of tools.
+# This cannot be combined with non-empty excluded_tools or included_optional_tools.
+fixed_tools: []
+
+# override of the corresponding setting in serena_config.yml, see the documentation there.
+# If null or missing, the value from the global config is used.
+symbol_info_budget:
+
+# The language backend to use for this project.
+# If not set, the global setting from serena_config.yml is used.
+# Valid values: LSP, JetBrains
+# Note: the backend is fixed at startup. If a project with a different backend
+# is activated post-init, an error will be returned.
+language_backend:

package/framework/skills/CLAUDE.md

@@ -0,0 +1 @@
+# Context cleared

package/framework/skills/audience-research-agent/CLAUDE.md

@@ -0,0 +1 @@
+# Context cleared