Skip to content

merge my content for build paths#133

Merged
RichmondAlake merged 83 commits into
oracle-devrel:mainfrom
jasperan:main
May 12, 2026
Merged

merge my content for build paths#133
RichmondAlake merged 83 commits into
oracle-devrel:mainfrom
jasperan:main

Conversation

@jasperan
Copy link
Copy Markdown
Member

No description provided.

jasperan and others added 30 commits April 17, 2026 05:26
…o gitignore

Replace 11 em-dashes in README.md with parentheticals, commas, and
periods. Add .agents/, .claude/, .crush/, .openhands/, .serena/, and
content/ to .gitignore to prevent committing agent-local directories.
- Remove unused private funcs flagged by staticcheck/deadcode:
  copyDirectory, ContextBuilder.loadSkills, AgentLoop.forceCompression,
  parseThinkingLevel, USBMonitor.cancel field
- Fix redundant nil checks before len() (S1009) in agent/loop.go
- Replace fmt.Print(fmt.Sprintf(...)) with fmt.Printf (S1038)
- Drop unnecessary fmt.Sprintf on literal strings (S1039) in
  channels/telegram.go and skills/loader.go
…loud/

- Add agent-reasoning, limitless-workflow, oracle-database-java-agent-memory,
  oracle-database-vector-search, picooraclaw, and vecdb to the Apps table
- Add 8 PR-contributed notebooks to the Notebooks table (agent_loop_foundations,
  agent_memory, agent_with_memory, fs_vs_dbs_oci_genai, onnx_embeddings,
  oracle_26ai_unique_features_demo, oracle_image_similarity_openclip,
  unified_agent_memory_oracle_ai_database)
- Group AWS/Azure/Google and MongoDB-API notebooks (madhusudhanrao-ppm
  contributions) under notebooks/multicloud/ with its own README
- Link the multicloud folder from the top-level Notebooks table
…ts baseline

Adds the shared jasperan-repo pre-commit template plus a repo-local
.secrets.baseline so detect-secrets skips the long-standing test
fixtures in pkg/migrate/migrate_test.go. Also widens .gitignore to
cover .omc/, Terraform local state, and Remotion generated output.
…Remotion promo project

- cmd/picooraclaw/internal/onboard/workspace/: source-of-truth workspace
  files extracted by the 'onboard' command.
- deploy/oci/.terraform.lock.hcl: locks Terraform provider versions for
  the OCI Resource Manager stack.
- remotion/: standalone Remotion project for the promo video. Its
  public/logo.png is a symlink to assets/new_logo.png to avoid duplicating
  the 692K binary; generated output in remotion/out/ is gitignored.

Refreshes .secrets.baseline with hashes from the new Remotion files.
…n_core Embeddings

OracleVS in langchain-oracledb 1.2+ calls _embed_documents() during
get_embedding_dimension() and only accepts an Embeddings instance or a
callable; a plain class with embed_query/embed_documents methods is
rejected with 'The embedding_function is neither Embeddings nor
callable.', breaking the agentic_rag integration job.
jasperan added 25 commits May 5, 2026 21:07
…helper

Additive layering — keeps the local-tool scaffold (mcp_client.py / tool_registry.py /
four-tool surface) intact. Adds six guidance blocks adapted from Oracle's official
SQLcl MCP skill (oracle/skills · db/sqlcl/sqlcl-mcp-server.md):

- SQLcl 25.2+ on PATH callout (transport option, no auto-switch)
- Recommended least-privilege DB user shape (cyp_mcp pattern)
- Hardened read-only regex (strips leading SQL comments, rejects EXPLAIN /
  CALL / BEGIN / DECLARE — closes a real demo footgun)
- /* LLM in use is <model> */ query tagging on every run_sql call
- Step 4.5: V$SESSION.MODULE/ACTION setter via dbms_application_info
- Step 4.6: optional CYP_MCP_LOG audit table (DBTOOLS$MCP_LOG-shaped)

Intermediate SKILL.md gets a thin pointer extending the existing 'Why MCP+SQLcl'
note: lists the three diagnostic queries and mentions SQLcl 25.2 as a drop-in
alternative transport.
…els on Oracle-tech slides

- slide 4: nine use cases overview (3 per tier, badge grid)
- slide 5: scan-the-QR for the API key + endpoint we provide for the session
- 13 feature panels (what / solves / achieves) on every slide that introduces
  an Oracle headline tech: 26ai converged, in-DB ONNX, OracleVS, Oracle MCP,
  SQLcl audit, Ollama-MCP swap, Select AI, oracleagentmemory, langchain-oracledb,
  onnx2oracle, JSON Duality, converged engine, and Oracle as the agent store
- denominator shifted 28 -> 30; existing slide IDs 4-28 shifted to 6-30
… endpoint

- replace QR-code slot with a direct pastebin.com/NVQb7PG4 link for the
  session API key
- inline the full us-phoenix-1 OpenAI-compat endpoint URL on the slide
  itself so attendees can copy without scanning anything
- shows curl + .env + verify.py in one mono block; no two-column QR layout
…RunSQLTool row formatter

The oracle-mcp-server-helper snippet returns rows as repr({columns, rows})
and never calls _render_cell. Both intermediate-nl2sql and
advanced-hybrid-analyst rewrote RunSQLTool to emit tab-separated output;
intermediate carried the helper through, advanced lost it during the
clone, breaking every data-route agent answer with NameError until
patched. Add an explicit callout + paste-ready helper to the skill so
future tiers that swap the formatter ship the renderer too. Helper also
materializes oracledb LOB columns (str(<lob>) otherwise renders garbage)
and clamps cells to 200 chars.
The Oracle 26ai Free image's multi-arch manifest auto-resolution is
unreliable when a stale image is on disk or the host VM is degraded,
so amd64 layers can land on an arm64 Mac. Under emulation, the
entrypoint's `su oracle` fails with "Authentication failure" and the
bootstrap aborts — but the old `echo 'SELECT 1 FROM DUAL;' | sqlplus
-L ... | grep -q '1'` healthcheck false-positives, because the digit
`1` appears in the resulting ORA-01034 banner. Compose reports the
container HEALTHY with zero Oracle processes inside, and the user
only discovers the DB is dead when the first oracledb.connect()
raises minutes later.

- shared/templates/docker-compose.oracle-free.yml: swap the grep-based
  healthcheck for `/opt/oracle/checkDBStatus.sh`, which the image
  ships and which returns 0 only when the PDB is actually OPEN.
- shared/references/oracle-26ai-free-docker.md: document the
  host-arch pre-flight (uname -m → linux/amd64 or linux/arm64,
  inspect any existing image, rmi on mismatch, then docker pull
  --platform) and explain why the old healthcheck is gone.
- skills/oracle-aidb-docker-setup/SKILL.md: insert Step 3b — the
  arch-check pre-flight — between compose-write and `compose up`,
  with a reminder in Step 4 not to regress the healthcheck.

No-op on amd64 Linux (existing image's Architecture already matches);
saves Mac users from an hour of "the container is healthy but I
can't connect" debugging the first time they scaffold a CYP project.
Retitles choose-your-path's README to "Build Paths" and rewrites the
intro to lead with the project's purpose: the path skills are Oracle
skills built by expert OCI developers and packaged so a user's coding
agent acts as if an Oracle engineer were sitting next to them while
they build. Three build paths, three sample apps per path, so users
pick the shape that matches what they're passionate about and improve
it with their own ideas — the Oracle skills don't change; the corner
they take Oracle into does.
@jasperan jasperan requested a review from RichmondAlake May 12, 2026 04:11
@jasperan jasperan self-assigned this May 12, 2026
@oracle-contributor-agreement oracle-contributor-agreement Bot added the OCA Verified All contributors have signed the Oracle Contributor Agreement. label May 12, 2026
Resolves conflicts on PR oracle-devrel#133 by taking upstream for:
- README.md (additive section from PR oracle-devrel#127, no overlapping edit)
- apps/agent-reasoning/interactive (Dependabot: next 16.2.2 → 16.2.3)
- apps/picooraclaw/remotion (Dependabot: @remotion/cli 4.0.301 → 4.0.456)
- guides/dlai_aidev_agent_memory.pptx (Eli's refreshed DLAI deck, PR oracle-devrel#128)

All choose-your-path commits land untouched — none of the six conflicts
were in CYP files.
@RichmondAlake RichmondAlake merged commit bdcc4d8 into oracle-devrel:main May 12, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

OCA Verified All contributors have signed the Oracle Contributor Agreement.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants