Repository navigation
Collapse into a single native ict binary with CLI and MCP views - #4
Merged
Merged
Conversation
Add the single-native-binary OpenSpec change: proposal, design, spec deltas and tasks for one GraalVM executable with CLI and MCP surfaces generated from a shared operation registry. Also ignore the machine-specific .dkf workspace pointer. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_014G7s6EEb4vJud4aCUkgJQU
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_014G7s6EEb4vJud4aCUkgJQU
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_014G7s6EEb4vJud4aCUkgJQU
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_014G7s6EEb4vJud4aCUkgJQU
Record the spike outcome in design D6: GraalVM CE 25, explicit sharedLibrary=false, picocli runtime generators, no wholesale JDK type registration, and a 13-entry hand-written metadata base. Retire the Quarkus fallback and align tasks 1.4, 5.1 and 5.2 with those findings. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_014G7s6EEb4vJud4aCUkGJQU
The Spring AI MCP module returned placeholder strings, the agent module was excluded from the build, and model-context-protocol held only an ignored sample build. Drop them with their Spring, Spring AI and langchain4j catalog entries; MCP returns as an ict subcommand in task 4. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_014G7s6EEb4vJud4aCUkGJQU
Move Verb, EntityType, Locus, SerializationFamily and SendMethod to org.ical4j.command.vocab inside ical4j-command-cli and delete the ical4j-command-core module. Nothing consumed the enums yet; the operation registry (task 2) will. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_014G7s6EEb4vJud4aCUkGJQU
Move ical4j-command-cli/src to the root, drop settings.gradle includes, and replace the subprojects build with one build.gradle carrying the application, native-image and publishing configuration. The native block comes from the spike: explicit sharedLibrary=false, toolchain detection off, picocli's runtime metadata generators with the java.net.URL strip. Publishing coordinates become org.ical4j:ict. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_014G7s6EEb4vJud4aCUkGJQU
Remove module-info.java, bnd.bnd, the bnd builder plugin and the OSGi annotation processors. Native image ignores JPMS, nothing in the tree used OSGi annotations, and an OSGi bundle was never a goal of the tool. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_014G7s6EEb4vJud4aCUkGJQU
Log everything to stderr through slf4j-simple so stdout carries only command output (and, later, the MCP protocol stream). slf4j-simple fixes its level when the first logger is created, before picocli has parsed --verbose, so LogLevel picks the level in main from the raw arguments and ICT_LOG_LEVEL and publishes it as a system property. The -v flag stays declared for help and parsing. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_014G7s6EEb4vJud4aCUkGJQU
Move the 65 picocli command classes, their 11 support classes, the 13 Spock specs and the geo.ics fixture to src/legacy, which no source set compiles. Package paths are unchanged so each operation can be moved back as it is re-admitted to the registry. CommandMain now declares no subcommands; the build is green with help, version and the LogLevel spec only. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_014G7s6EEb4vJud4aCUkGJQU
Add docs/dropped-commands.md listing the 65 legacy commands with their old invocation, intended (verb, type, locus), cohort and known issues, plus the vocabulary gaps the mapping exposes for the registry design. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_014G7s6EEb4vJud4aCUkGJQU
Add org.ical4j.command.ops: Operation and OperationId (verb, subject, locus), surface-neutral Param descriptors with typed Params access and default/required resolution, structured Result records, a Context that carries stores and stdin, Handler, typed OperationException, and Surface. Settle the vocabulary gaps: Subject unifies entity types, serialization families and container loci as the type axis; Locus gains NONE and CHANNEL, which cannot be subjects. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_014G7s6EEb4vJud4aCUkGJQU
An immutable table of operations built once at startup. The builder rejects a second registration of the same (verb, subject, locus) tuple, and the registry offers lookup by identity, filtering by surface, grouping by verb for help output, and execution by identity. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_014G7s6EEb4vJud4aCUkGJQU
CommandConfig now takes an explicit data directory (ICT_DATA_DIR overrides the platform default), passes the TOML format to night-config explicitly so native images need no reflection entry, creates its application directory, and loads defaults from the renamed ictrc.default.toml, which the old code never found. context() yields a Context with the active workspace, lazily opened local stores and stdin. The static INSTANCE singleton is gone; surfaces build one. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_014G7s6EEb4vJud4aCUkGJQU
Operations.standard() is the single assembly point for admitted operations. RegistryConformanceTest fails if any registered tuple is not named, as the literal text of OperationId.toString(), by some spec under src/test/groovy, and if any operation is exposed to no surface. OperationId.parse() turns that literal back into an identity so specs fetch their operation by the same text. The scanner is checked against a fake registry in a temp dir. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_014G7s6EEb4vJud4aCUkGJQU
Register add/get/remove/list collection in workspace, import/export/ remove calendar and card in collection, and list event/action/note/ entity in collection, as handlers over the connector API with connector failures mapped to typed OperationExceptions. Each group has a Spock spec against LocalCalendarStore/LocalCardStore on a temp directory, naming its tuples for the conformance test. The ten legacy command classes and their mock-based specs are deleted from src/legacy. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_014G7s6EEb4vJud4aCUkGJQU
Renderer turns any Result into text in a Format: iCalendar/vCard, aligned tables and plain lines for TEXT; jCal/jCard and plain JSON for JSON; xCal/xCard for XML. jCard is applied per entity, which is what the serializer expects and why the legacy converter cycled on VCard. Validation results carry severity, context and message and render in the old report format. Descriptor attributes keep insertion order. The legacy DefaultOutputHandlers and its spec are deleted. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_014G7s6EEb4vJud4aCUkGJQU
Main builds a verb-first picocli tree from the registry at startup: one subcommand per verb, one per (verb, subject) under it, options from the Param descriptors. Global options are inherited, exit codes are 0/1/2, and diagnostics go to stderr only. `ict config` replaces ConfigureCommand. The collection operations take `--collection` rather than `--name`. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Each MCP-exposed operation becomes a `<verb>_<subject>` tool whose input schema is generated from its Param descriptors, served by the MCP Java SDK's synchronous server on stdio. Calendars and cards are returned as text and other results as JSON; operation failures come back as isError results. stdout carries protocol messages only, and the server exits when its input closes. Uses mcp-core with mcp-json-jackson2 rather than the `mcp` aggregate, which would bring a second Jackson. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Reachability metadata is the spike's base file merged with a capture from running the smoke suite under the tracing agent (mergeTracedMetadata). The smoke suite drives any `ict` command prefix, covering --help, every registered operation and an MCP handshake, and refuses to run if an operation has no step. nativeStartup fails if the median `ict --help` exceeds 100 ms. `export calendar` now adds a VTIMEZONE for each referenced TZID. `import calendar` adds missing time zones before merging, because the connector fails with an NPE on multi-object input without them. SDKROOT is passed through to native-image for macOS 27 hosts. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
build.yml runs the JVM specs and smoke suite on every push and pull request, plus one linux x64 native smoke and startup job. release.yml builds and smoke-tests the executable for linux x64/arm64, macOS arm64 and windows x64, then attaches them with SHA-256 checksums to a GitHub Release and publishes the jar to Maven Central. publish-snapshots.yml tests locally instead of calling ical4j's reusable workflow. The Makefile gains native and smoke targets and loses the S3 uploadDist. Release tags take the ict- prefix. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The README covers installing a release executable, verb-first usage, output formats, exit codes, configuration and MCP client setup. command-protocols.md describes the registry, its CLI and MCP views, and how an operation is admitted, in place of per-class listings. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Syncs its delta specs into openspec/specs. This adds the cli-surface, mcp-surface, native-binary and operation-registry capabilities, and updates command-vocabulary: the vocabulary now lives in the vocab package and dispatch goes through the registry. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Implements the OpenSpec change
single-native-binary, now archived underopenspec/changes/archive/2026-10-11-single-native-binary/, with its specs synced toopenspec/specs/.What changes
org.ical4j:ict. Spring, Spring AI, langchain4j, log4j and OSGi packaging are gone, and logging is slf4j-simple to stderr.Result, and typed failures. The first cohort covers collections, calendar and card import/export/remove, and listing entities. The old command classes are quarantined insrc/legacy/, anddocs/dropped-commands.mdmaps each one to its registry tuple. A conformance spec fails the build for any operation that no specification covers.ict <verb> <type> [--options], generated from the registry at startup.--workspace,--format text|json|xml,-v,-q,--lenient.ict configreplacesConfigureCommand.ict mcpserves the same registry as<verb>_<type>tools over stdio, using MCP Java SDK 2.0.1, with input schemas derived from the parameters. Failures come back asisErrorresults, and stdout carries only protocol messages.ict --helpis 9 ms.mergeTracedMetadatarefreshes it from a smoke run under the tracing agent.jvmSmoke,nativeSmoke) won't run if an operation has no step in it.export calendarnow adds a VTIMEZONE for each TZID it references.import calendaradds missing time zones before merging. This works around a null-pointer crash in the connector library when several objects reference a TZID.--collectionrather than--name.build.ymlruns the JVM specs, the JVM smoke run and one linux x64 native smoke job.release.ymlruns onict-*tags. It builds and smoke-tests native executables for linux x64/arm64, macOS arm64 and windows x64, then publishes checksums, a GitHub Release and the jar to Maven Central.ict-, so the version restarts at 0.1.0.uploadDisttarget and its settings are removed.README.mdanddocs/command-protocols.mdare rewritten around the registry and its two views.Testing
./gradlew build jvmSmokepasses locally.nativeSmokeandnativeStartuppass against a native binary built locally on macOS arm64 (GraalVM CE 25.3.4).release.ymlhas not run yet; the firstict-*tag will be its first test.Notes for reviewers
mcp-core+mcp-json-jackson2rather than themcpaggregate, which would put Jackson 3 into the image next to Jackson 2.SDKROOTto an older SDK before building natively (see README). The build passes it through to native-image.🤖 Generated with Claude Code