v1.6.0 โ Template Packages and Native Distribution¶
Purpose: Defines version-level CLI, API, SDK, dashboard, schema, and compatibility obligations. Audience: product, architecture, engineering, security, operations, documentation, release, and AI coding agents Owner: Template and Distribution Maintainers Roadmap authority:
docs/strategy/FORGEVENA_VERSIONED_PRODUCT_ROADMAP.md#9-v160--template-packages-and-native-distributionLifecycle: planned Review: before implementation and at every lifecycle promotion
Contract Rules¶
- Preserve
forgevena,ai-workspace,.ai-workspace/, structured envelopes, preview-first mutation, and explicit external consent. - Add interfaces only through versioned schemas and shared domain services.
- Document authentication references, permissions, rate limits, pagination, errors, idempotency, cancellation, and compatibility.
- Never place credentials or sensitive content in arguments, URLs, logs, state, diagnostics, or evidence.
Surface Impact¶
- Version template package, catalog, inheritance, lockfile, and signature schemas.
- Add catalog, inspect, verify, test, export, publish, deprecate, and drift-plan commands.
Compatibility¶
Backward compatibility is required throughout 1.x. Later breaking changes require deprecation, migration preview, compatibility reports, rollback, and support for the final prior-major release.