Skip to content

Table stakes for a public library set #10

Description

@Ugbot

tracker: AGS-34

Verified absent: CONTRIBUTING.md, CHANGELOG.md, SECURITY.md, CODE_OF_CONDUCT.md, NOTICE, any versioning/semver policy, any deprecation policy, a compatibility matrix (framework ↔ Flink ↔ langchain4j), javadoc generation or publishing, a Maven wrapper, Dependabot config, and install instructions with actual coordinates. Git tags: 0.

Present and correct: LICENSE (Apache-2.0), python/LICENSE, a thorough .gitignore, python/PUBLISHING.md, and a large docs/ tree.

Also needed before 1.0: an API-stability surface (no @Public/@Experimental/@Internal markers exist, and no @Deprecated annotations despite a documented deprecated path), and a getting-started path that does not require installing Ollama, pulling models and running a Qdrant container first.

Includes documenting AI-grind as the supported local dev toolchain — this audit had to discover that there is no mvn on PATH, no JDK 17 installed (21 works), and that timeout/go/clojure/a modern Python all had to be installed before the Go, Clojure and Python surfaces could be verified at all. A documented AI-grind bootstrap for the polyglot toolchain would make a contributor productive on day one.


Roadmap epic. Detailed findings, file:line citations and sub-tasks live in the AI-grind tracker (project AGS), which is the source of truth for this work. Local dev — build, test, tracking, profiling — is managed with AI-grind.


Tracked as AGS-34 in the devtools-mcp tracker.

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions