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.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

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