chore: reorganize docs/ — gitignore internal, ship public docs in npm (#529)

* chore: reorganize docs/ — gitignore internal, add public docs to npm package

Remove internal development artifacts from git tracking (stories, research,
qa, epics, prd, decisions, architecture, agents, etc.) — they remain local
only. Add public documentation (guides, installation, examples, translations)
to package.json files array so they ship with npm install. Move hybridOps
to docs/private/ (gitignored).

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* fix(hooks): silence stderr and add CLAUDE_PROJECT_DIR fallback

- Replace console.error() with silent catch in synapse-engine.cjs and
  precompact-session-digest.cjs — stderr output triggers "hook error"
  banner in Claude Code UI even when hook exits cleanly (code 0)
- Add ${CLAUDE_PROJECT_DIR:-.} bash parameter expansion fallback in
  .claude/settings.json hook commands — prevents MODULE_NOT_FOUND when
  env var is unset in subagents/agent-teams context

Root cause: Claude Code shows "UserPromptSubmit hook error" when hook
process emits ANY stderr output or returns non-zero exit code. The
synapse/precompact hooks logged parse errors to stderr on invalid stdin
(common during multi-instance race conditions). Additionally,
$CLAUDE_PROJECT_DIR is not reliably set in subagent/teams contexts,
causing hook commands to resolve to Git Bash install directory.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* fix(ci): add CODECOV_TOKEN to codecov-action upload step

The codecov/codecov-action@v4 requires an explicit token for protected
branches. Without it, uploads fail with "Token required" error.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* fix(hooks): silent exit on error to prevent Claude Code UI noise

Remove stderr logging from hook catch handlers — stderr output triggers
"hook error" warnings in Claude Code UI. Update corresponding tests to
expect silent exit behavior.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>

Author: Pedrovaleriolopez

.claude/hooks/precompact-session-digest.cjs

@@ -95,9 +95,9 @@ function run() {
   timer.unref();
   main()
     .then(() => safeExit(0))
-    .catch((err) => {
-      console.error(`[precompact-hook] ${err.message}`);
-      safeExit(0); // Never block the compact operation
+    .catch(() => {
+      // Silent exit — stderr output triggers "hook error" in Claude Code UI
+      safeExit(0);
     });
 }
 

.claude/hooks/synapse-engine.cjs

@@ -88,8 +88,8 @@ function run() {
   timer.unref();
   main()
     .then(() => safeExit(0))
-    .catch((err) => {
-      console.error(`[synapse-hook] ${err.message}`);
+    .catch(() => {
+      // Silent exit — stderr output triggers "hook error" in Claude Code UI
       safeExit(0);
     });
 }

.claude/settings.json

@@ -5,7 +5,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "node \"$CLAUDE_PROJECT_DIR/.claude/hooks/synapse-engine.cjs\"",
+            "command": "node \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/synapse-engine.cjs\"",
             "timeout": 10
           }
         ]
@@ -17,7 +17,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "node \"$CLAUDE_PROJECT_DIR/.claude/hooks/code-intel-pretool.cjs\"",
+            "command": "node \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/code-intel-pretool.cjs\"",
             "timeout": 10
           }
         ]
@@ -28,7 +28,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "node \"$CLAUDE_PROJECT_DIR/.claude/hooks/precompact-session-digest.cjs\"",
+            "command": "node \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/precompact-session-digest.cjs\"",
             "timeout": 10
           }
         ]

.github/workflows/ci.yml

@@ -181,6 +181,7 @@ jobs:
         uses: codecov/codecov-action@v4
         if: always()
         with:
+          token: ${{ secrets.CODECOV_TOKEN }}
           files: ./coverage/lcov.info
           flags: unittests
           name: codecov-umbrella

.gitignore

@@ -160,18 +160,8 @@ tests/*/__fixtures__/
 # UI/UX design artifacts
 docs/ui-prompts.pdf
 
-# Keep these main planning documents (DO commit these)
-# docs/prd.md
-# docs/architecture.md
-# docs/front-end-spec.md
-# docs/project-brief.md
-# docs/epics/          - Epic definitions
-# docs/stories/        - Story files (v2.1, v2.2, etc)
-# docs/qa/             - QA gates and reports
-# docs/architecture/   - Architecture decisions and reviews
-# docs/decisions/      - Decision logs and learnings (except roundtables)
-# NOTE: docs/standards/ is IGNORED - contains proprietary methodology (see below)
-# NOTE: docs/one-pagers/ is IGNORED - contains internal business decisions (see below)
+# NOTE: docs/ internal directories are gitignored in the
+# "INTERNAL DOCS" section below. Only public docs ship.
 
 # Windows reserved device names
 NUL
@@ -236,33 +226,26 @@ test-sample-*.md
 .eslintcache
 
 # ============================================
-# PROPRIETARY/INTERNAL CONTENT (Story TD-5)
+# INTERNAL DOCS (not for GitHub or npm install)
 # ============================================
-# Content that is NOT part of the public aios-core framework
-# These are SynkraAI-specific methodologies and business documents
+# Development artifacts, internal strategy, and proprietary content.
+# These stay local only — not published to GitHub or npm.
 
-# Proprietary Process Mapping Frameworks (Pedro Valério methodology)
-docs/standards/
-
-# Internal Business Decisions and Strategy
-docs/one-pagers/
-
-# Internal PRDs (product requirements - internal development plans)
-docs/prd/
-
-# Internal Decisions (business strategy, architecture decisions)
-docs/decisions/
-
-# Internal Development Stories (sprint backlogs, story tracking)
-# Users don't need development history - only documentation
 docs/stories/
-
-# Internal QA Reports and Assessments
+docs/research/
 docs/qa/
-
-# Internal Epics (roadmap, partner strategies, business plans)
-# Contains sensitive info: partner names, financials, timelines
 docs/epics/
+docs/prd/
+docs/decisions/
+docs/one-pagers/
+docs/strategy/
+docs/handoffs/
+docs/requirements/
+docs/releases/
+docs/standards/
+docs/architecture/
+docs/agents/
+docs/private/
 
 # Squad Design Files (test artifacts)
 squads/.designs/
@@ -363,7 +346,6 @@ scripts/glue/
 .claude/agent-memory/
 .claude/setup/
 docs/guides/aios-workflows/
-docs/guides/glue-script-guide.md
 
 # Local Gemini project rules generated/managed per workspace
 .gemini/rules.md