Commit Graph

80 Commits

Author SHA1 Message Date
e33a6d6704 feat(standards): serve service version-wiring rule + bundle wiki pages in MCP
Versioning standard now states services must read their VERSION (e.g. a build arg) rather than hardcoding it; the compliance prompt repeats it. build_bundle also bundles src/wiki/** as wiki_-prefixed modules (e.g. docs://modules/wiki_development_releasing), so the release runbook is reachable from the MCP. Bundle grows to 22 modules.
2026-10-15 18:50:03 +05:30
5971f26c08 feat(standards): MR-based tag strategy + repository inventory (registry://repos)
Versioning standard now documents the MR flow: bump pyproject.toml/VERSION and promote CHANGELOG in the MR (referencing the version/tag, not a commit id), merge/squash, then tag the resulting commit. Adds the agent-assisted tagging procedure (wait for the go-ahead, find the version-bump commit, tag only it, ask the user to push) to both the reference page and the releasing wiki runbook. Adds the repo inventory (src/repos.json -> mcp/repos.json), the registry://repos resource + list_repos tool, the 15_repository_inventory lib page, and two MCP prompts: compliance (remediate repos) and release (agent tagging).
2026-10-15 14:39:21 +05:30
df03f41771 docs(standards): rebuild lib + wiki HTML for versioning/changelog and drone pages 2026-10-15 14:21:50 +05:30
8cc9631fe7 feat(standards): add versioning + changelog standard, release templates, and Drone version guard
Add lib page 11 (SemVer contract, pre-1.0 rule, tag==version invariant, Keep a Changelog), the releasing wiki runbook, and canonical release templates (CHANGELOG.md, VERSION). Vendor them into the MCP bundle as templates/release + release.json and expose registry://release with list/get tools. Add a changelog component to the app template. Enforce the tag<->version contract in both Drone shapes: Type A check-version and the backfill loop verify pyproject version; Type B adds a VERSION guard step.
2026-10-15 01:24:25 +05:30
a754366901 feat(standards): add Drone CI standard (PyPI package + Docker deployment)
Document the two `.drone.yml` shapes used across the org, derived from the
repos:

- Type A `python-lib.yaml`: build-and-publish-pypi + backfill-pypi-from-tags
- Type B `service-docker.yaml`: build-and-deploy-service + build-and-deploy-site

- add reference page `10_drone_pipelines`
- vendor `src/templates/drone/` into the MCP bundle (`drone.json`)
- expose `registry://drone` + `list_drone_templates` / `get_drone_template`
- wire `build.py` to vendor drone templates; rebuild nav/index (14 modules)
2026-10-15 00:52:38 +05:30
18d52bdb7c feat(standards): integrate auth-server via pinned spec (docs://spec) + auth recipe and template slice
- serve the pinned auth-server OpenAPI contract as the standards MCP resource docs://spec (no auth-server MCP bundle)
- add Auth Integration recipe (14) and wire it into the registry, prompts, index, and nav
- un-defer Auth Server in the library registry (spec/recipe pointers)
- ship the opt-in template auth slice: interfaces/auth/ (placeholder + mergeable bearerAuth security.yaml) and AUTH_SERVER/JWT_SERVER env
- rebuild bundle (13 modules, 44 components); template stays authless by default
2026-10-14 16:18:14 +05:30
6c0d859a1e feat(standards): fix F11-F16 and rebuild bundle (43 components) + trial findings
- F11 PopulateRule field_name/collection_name corrections
- F12 service adaptor update handles PopulatingRepository
- F13 nested-references section; F14 authless /users/me guidance
- F15 template ruff-clean; F16 stop vendoring .ruff_cache, ship .gitignore
- document --template-style in build_recipe/spec_first_routing; refresh collected
  openapi-first + standards bundle (12 modules, 43 components)
- add trial.md and trial_findings.md (F1-F16, re-trial A/B evidence)
2026-10-13 19:35:12 +05:30
fced40af59 feat(standards): codify codegen, ship generic Tier-B infra, add get_app_template + prompts; fix docs:// regressions
P0: fix doc:// -> docs:// across standards src/server/registry and regenerate stale mongo-ops bundle. P1: build recipe + spec-first routing now document the openapi-first codegen fast path (models/routes with --inject-request/--package). P4: CRUD template documents the model-vs-document id rule (BaseDocument owns id). P5: authless guidance (omit security keys). P6: template gains generic infra (http_cache, keyed SSE bus, KV port+in-memory+Redis), interfaces/openapi.py + .dockerignore + generic build test registered as components, and a get_app_template tool; genericity matrix marks LLM pool + human-in-loop as reference-app patterns. P7: intake/build/start_app/trial prompts. P8: template ships tests/integration/test_openapi_app_builds.py. Rebuilt standards + openapi-first bundles and re-collected.
2026-10-13 03:26:51 +05:30
ef951a1913 use docs:// instead of doc:// to maintain parity with other mcp docs 2026-10-12 22:22:09 +05:30
e15864f82f build(standards): rebuild bundle and collect docs (build_recipe module, start-an-app page) 2026-10-12 21:31:38 +05:30
3e5905eacb docs(standards): move build recipe into the MCP bundle; add Start an App entry point 2026-10-12 21:26:40 +05:30
2d1278911c docs(standards): vendor template into MCP bundle; add component tools + start_app prompt 2026-10-12 21:24:10 +05:30
715bfd8022 docs(standards): document internal-library bootstrap; wire private index into template Dockerfile 2026-10-12 21:20:38 +05:30
52b4d76d93 docs(standards): add reusable Tier-B template scaffolds (pipeline family, shared loader/registry, converters, scripts) 2026-10-12 21:08:19 +05:30
99fac53c2b docs(standards): split genericity matrix and infra adapters into Tier A/B/C 2026-10-12 21:06:35 +05:30
9390839d9b docs(standards): assign Hexa MCP port 8008; mark Auth Server deferred 2026-10-12 21:05:34 +05:30
7d1694148a docs(standards): align layering docs with the port seam; split runtime vs wiring diagrams 2026-10-12 13:15:35 +05:30
8a10c4768c docs(standards): horizontal nav tabs; top-to-bottom component diagram
- mkdocs.wiki.yml: enable navigation.tabs, toc.integrate, header.autohide

- 02_components.md: flowchart TB with increased rank spacing for clarity
2026-10-12 12:35:35 +05:30
06ff5bce6e docs(standards): mirror doc-forge wiki style; mermaid + copyable build prompt
- move templates into src/templates; renumber wiki pages; add app-components page

- embed agentic build prompt as a copyable markdown block; add mermaid diagrams

- build.py writes <name>/mcp; config static bundle -> standards/mcp

- registry reads libraries.json as bytes (committed file was UTF-16LE); normalize to UTF-8

- Dockerfile: drop stale blog copy; per-repo <name>/mcp copies

- drop nested standards/mcp/standards duplicate and empty root mcp/
2026-10-12 00:21:41 +05:30
9929f05334 refactor: serve MCP bundles under <name>/mcp with nginx guard; rename core->mcp_server
- collect.py: copy repo MCP bundles to ROOT/<name>/mcp (instead of ROOT/mcp/<name>); add nginx location guard to deny /<name>/mcp/
- config.py: bundle roots now point to <repo>/mcp and standards/mcp for static bundles
- Rename core.py -> mcp_server.py and update imports in main.py and registry.py
- Dockerfile: per-repo MCP COPYs under /app/<name>/mcp, drop blog copy; add ports 8008/8009 in .drone.yml
- Restore standards/mcp/libraries.json from git for registry server
2026-10-11 23:37:46 +05:30
c5619bc5e8 fix: vendor per-kind sites in the hub; drop stale blog docs
- collect.py: when a kind points at the shared site root, copy only the
  per-kind subdir (site/lib -> <repo>/lib) instead of the whole site, so
  stray single-site build output never leaks into the hub
- Purge stale collected artifacts (404.html, assets/, search/, sitemaps,
  objects.inv, duplicate mcp/) from every repo dir, matching the cleaned
  source site/ roots
- Refresh collected output from source repos, incl. the khata-app app
- Remove the vendored Blog API docs (config.yml entry + blog/) and its card
2026-10-11 23:12:19 +05:30
74aaf2f53e refactor: conform standards docs to doc-forge wiki/lib layout; generic build.py; static kind links 2026-10-11 23:04:56 +05:30
1208945e1d feat: add standards wiki, MCP registry, and app template 2026-10-11 22:09:30 +05:30
1ef2efbeda feat: collect khata-app lib, api and wiki 2026-09-18 17:07:40 +05:30
b3b1c3404b feat: collect py-jwt wiki; register wiki kind; refresh lib and mcp artifacts
Adds the py-jwt wiki to the hub alongside lib and mcp and picks up
the regenerated flat lib reference and standardized MCP modules.
2026-09-16 20:08:15 +05:30
b1447fb72b feat: collect mail-intake wiki; register wiki kind; refresh lib and mcp artifacts
Adds the mail-intake wiki to the hub alongside lib and mcp and picks up
the regenerated flat lib reference and standardized MCP modules.
2026-09-16 20:02:55 +05:30
aedd2061e1 feat: collect omniread wiki; register wiki kind; refresh lib and mcp artifacts
Adds the omniread wiki to the hub alongside lib and mcp and completes the
library nav with csv/xlsx groups, picking up regenerated MCP modules.
2026-09-16 19:59:00 +05:30
a115df113d chore: collect auth-server wiki and lib refresh
Picks up the rewritten auth-server wiki (platform anatomy theme) and the
regenerated lib artifacts, including the new pep-typed marker bounce.
2026-09-16 19:51:24 +05:30
7aadae1736 feat: collect dagpipe wiki, refresh lib and mcp artifacts
Enables dagpipe wiki on the docs hub alongside lib and mcp, removes stale nested lib pages, and picks up regenerated GSDFC docstrings in the MCP bundle.
2026-09-16 15:43:14 +05:30
a51082fe77 docs: collect openapi-first wiki and refresh openapi-first lib docs; regenerate homepage 2026-09-15 22:36:51 +05:30
58544c4524 docs: collect hexa wiki and re-collect dagpipe, hexa and omniread lib sites 2026-09-15 19:34:33 +05:30
b1f5ce092a updated hexa and docforge docs 2026-09-15 16:53:19 +05:30
27f76c7831 docs(wiki): added more rules and explanation on how to use the prompt in docforge wiki 2026-09-15 14:02:07 +05:30
48631b57c5 docs(wiki): align wiki structure with Aetoskia AGENTS.md guidelines
- Renamed `02_architecture.md` to `02_components.md` to match the standard component page naming convention.
- Updated `docs/mkdocs.wiki.yml` to reflect renamed pages and fix navigation label acronym casing (GSDFC, MCP, MkDocs).
- Updated `index.md` to include the mandatory doc model blockquote, standardize section headers with emojis, and accurately map the `Documentation Structure` table to the navigation menu.
- Standardized all wiki pages (`01_overview.md`, `02_components.md`, `03_conventions.md`, `04_iterative_workflow.md`, and `05_development/*`) by:
  - Adding horizontal rules (`---`) between major sections.
  - Applying emoji-prefixed H2 headings for recognizable section types.
  - Appending `## Related` or `## ➡️ Read Next` footers with standard relative cross-links.
  - Adjusting H1 headers to match guide anatomy (e.g., `# Library Overview` on the overview page).
2026-09-14 23:30:51 +05:30
37f2fbf4b9 docs(wiki): added copyable prompt to generate wiki in doc-forge wiki 2026-09-14 23:10:04 +05:30
49a00351bb docs: collect mongo-ops lib (mkdocstrings) + wiki into separate site subpaths, fix mcp server name, expose port 8007
- mongo-ops now serves /mongo-ops/wiki/ and /mongo-ops/lib/ independently
- add mongo-ops MCP bundle under mcp/mongo-ops
- fix copy-paste mcp server (jwtlib -> mongo_ops) in config.yml
- .drone.yml/Dockerfile: publish port 8007 for mongo-ops MCP
2026-09-14 22:33:34 +05:30
1bfbbebfa3 docs: collect mongo-ops wiki (UC 18 aggregation + UC 19 bulk ops in Advanced Usage, Testing merged into top-level tab, Common Patterns removed, prev/next footer enabled) 2026-09-14 21:16:46 +05:30
9aa4d5b438 docs: collect refreshed mongo-ops wiki site (UC 17 Related cross-links + themed index map) 2026-09-14 21:02:19 +05:30
be1a5abe25 docs: collect mongo-ops wiki with Use Cases promoted to its own tab (themed groups) 2026-09-14 20:20:29 +05:30
1e560f9a35 docs: collect refreshed mongo-ops wiki site (UC17 populate/depopulate worked examples) 2026-09-14 20:19:22 +05:30
317fd128bf docs: collect refreshed mongo-ops wiki site (UC15/16 deep dives, UC10 cache-miss fix, corrected cache imports) 2026-09-14 14:37:23 +05:30
f406aa2f21 docs: collect refreshed mongo-ops wiki site (API-correct overhaul, v0.1.5) 2026-09-14 13:46:11 +05:30
bbd9863d23 refresh collected sites/mcp for docstring changes in dagpipe, mail-intake, openapi-first 2026-09-14 00:18:17 +05:30
9516e0b4cb docs: refresh collected sites after per-kind mkdocs config standardisation 2026-09-13 18:26:26 +05:30
e272527b88 docs: refresh collected sites and MCP bundles after GSDFC docstring conformance 2026-09-13 16:24:16 +05:30
754255166f refactored view docs to view api 2026-09-12 15:01:55 +05:30
6124d8c1e8 docs: add auth-server lib and wiki sites and refresh collections 2026-09-12 14:58:43 +05:30
bf83538136 docs: refresh doc-forge split sites (lib + wiki) 2026-09-12 14:23:24 +05:30
167d44fcfe docs: refresh doc-forge library and MCP bundle
- collect regenerated doc-forge combined site (wiki + lib)
- drop stale lib/docforge duplicate subtree
- mcp bundle now uses docs:// module resources
2026-09-12 13:12:55 +05:30
bd8ba6e67c feat: regroup homepage into apps/tutorial/services/libraries cards
- assign each repo a section via config.yml (blog -> apps,
  media-manager -> tutorial, auth-server -> services, rest -> libraries)
- render one card per repo with a bottom-justified action row containing
  one link per available kind (view docs / view wiki / view lib /
  view tutorial)
- switch card grid to three columns with responsive breakpoints and
  taller cards
2026-09-11 23:49:59 +05:30