thanhnvandClaude Opus 4.8
ff4e9d5a53
Answers the 3 adoption questions (Plan-21 follow-up):
1) LEVEL SELECTION (4 packaging levels, packaging/levels.json):
- install.sh --level core|devkit; platform refused (preview service),
enterprise refused (future). Level recorded in .casan-level.
- casan init --level 1..4: L1=gate+Plan-20 hooks only; L2=+CI+domain-pack;
L3=L2 base+preview note; L4=refused. New `casan level show|set`.
- levels.json core now includes adapters/ + schemas/ + install scripts.
2) EXISTING SHELLS (agents/skills): init MERGES Plan-20 hooks into an existing
.claude/settings.json and .codex/{hooks.json,config.toml} idempotently
instead of clobbering — preserves the project's own hooks/agents/skills and
unrelated keys. Re-running never duplicates the CASAN hook.
3) NO RE-INDEX / NO SHELL REWRITE: init only adds config; it does not parse or
index code and does not rewrite the project shell.
Safety fixes after a test accidentally ran init in the real repo:
- launcher shim now SELF-LOCATES its install from its own path (no ambient
CASAN_HOME cross-talk).
- casan init REFUSES to adopt a CASAN source hub into itself (--force to
override), so the Plan-20 hooks can't block the developing agent.
- test always runs init inside throwaway dirs; +source-hub guard test.
hybrid-install-tests.sh: 41/41 PASS.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
125 lines
6.9 KiB
JSON
125 lines
6.9 KiB
JSON
{
|
|
"casan_packaging": "level-based source hub",
|
|
"version": "1.0.0",
|
|
"note": "Single source of truth for what each release bundle contains and its maturity. The repo is a source hub holding all levels; releases are SPLIT so downstream adopts only the level it needs. See docs/packaging/CASAN_PACKAGING_PLAN.md.",
|
|
"levels": {
|
|
"core": {
|
|
"level": 1,
|
|
"package_names": ["casan-core", "casan-harness"],
|
|
"status": "implemented",
|
|
"summary": "H1-H7 harness core, security/action gates, evidence pack, audit, cost/telemetry, hardening tests, policy/config defaults, lightweight CLI.",
|
|
"target_users": ["governance-harness-only projects", "BJT initial adoption", "CI gate usage"],
|
|
"includes": [
|
|
"packages/casan-harness/scripts",
|
|
"packages/casan-harness/security",
|
|
"packages/casan-harness/governance",
|
|
"packages/casan-harness/agentops",
|
|
"packages/casan-harness/config",
|
|
"packages/casan-harness/level5",
|
|
"packages/casan-harness/memory",
|
|
"packages/casan-harness/templates",
|
|
"packages/casan-harness/tests",
|
|
"packages/casan-harness/adapters",
|
|
"packages/casan-harness/schemas",
|
|
"packages/casan-harness/init-options.json",
|
|
"packages/casan-harness/README.md",
|
|
"bin/casan",
|
|
"install.sh",
|
|
"install.ps1",
|
|
"packaging/levels.json",
|
|
"VERSION"
|
|
],
|
|
"excludes_globs": ["**/__pycache__/**", "**/*.pyc", "**/.DS_Store"],
|
|
"artifact": "casan-core-v{VERSION}.tar.gz",
|
|
"docker_image": "casan-harness:{VERSION}"
|
|
},
|
|
"devkit": {
|
|
"level": 2,
|
|
"package_names": ["casan-devkit", "casan-project-kit"],
|
|
"status": "implemented",
|
|
"summary": "Level 1 + project templates, domain-pack scaffold, Gitea workflow templates, harness Dockerfile, install script, adoption/CI/domain-pack guides.",
|
|
"target_users": ["new projects adopting CASAN", "internal teams needing a repeatable setup"],
|
|
"extends": "core",
|
|
"includes": [
|
|
"packages/casan-devkit",
|
|
"docs/packaging/ADOPTION_GUIDE.md",
|
|
"docs/packaging/CI_GUIDE.md",
|
|
"docs/packaging/DOMAIN_PACK_GUIDE.md",
|
|
"docs/packaging/DOCKER_GUIDE.md",
|
|
"docs/packaging/CASAN_PACKAGING_PLAN.md",
|
|
"scripts/package-release.sh"
|
|
],
|
|
"artifact": "casan-devkit-v{VERSION}.tar.gz"
|
|
},
|
|
"platform": {
|
|
"level": 3,
|
|
"package_names": ["casan-platform", "casan-control-panel"],
|
|
"status": "preview",
|
|
"summary": "Optional productization UI: packaged Control Panel, AgentOps dashboard, Run History, governed settings, approvals, kill-switch, FinOps/SLO, Command Center, Governed Chat MVP and Evidence Pack Viewer. Attack Battery Viewer, Gitea webhook publishing and managed production rollout remain preview work.",
|
|
"target_users": ["teams wanting UI/dashboard/visibility", "demo/training/productization"],
|
|
"extends": "devkit",
|
|
"implemented_components": ["agentops-dashboard", "control-panel monitoring and run history", "governed settings and rollback", "RBAC and approval inbox", "kill-switch", "FinOps/SLO", "Command Center", "Governed Chat read-only/analysis/operator/codegen MVP", "agent/skill/model selection", "Evidence Pack Viewer", "local-prod TLS/OIDC smoke"],
|
|
"pending_components": ["managed production deploy with enterprise IdP/cert/host", "attack-battery-viewer", "gitea-webhook evidence publishing"],
|
|
"includes": [
|
|
"packages/casan-platform",
|
|
"packages/casan-control-panel",
|
|
"packages/casan-harness/scripts/bash/dashboard-server.py",
|
|
"packages/casan-harness/scripts/bash/dashboard-serve.sh",
|
|
"package.json",
|
|
"package-lock.json",
|
|
"Dockerfile.control-panel-api",
|
|
"Dockerfile.control-panel-ui",
|
|
"docker-compose.control-panel.yml",
|
|
"docker-compose.control-panel.local.yml",
|
|
"nginx/control-panel.conf",
|
|
"packaging/control-panel-oauth2-proxy.env.example",
|
|
"infra/local-prod/idp",
|
|
"infra/production",
|
|
"docs/security/CONTROL_PANEL_AUTH_HARDENING.md",
|
|
"docs/packaging/EDITION_FEATURE_LIMITATION_MATRIX.md",
|
|
"docs/jp-poc",
|
|
"docs/commercial/LICENSE_AND_IP_DECISION.md",
|
|
"docs/commercial/THIRD_PARTY_SOFTWARE.json",
|
|
"docs/technical_architecture.md",
|
|
"apps/okr/domain",
|
|
"apps/okr/frontend",
|
|
"apps/okr/backend",
|
|
"apps/service-desk",
|
|
"scripts/smoke-release-artifact.sh"
|
|
],
|
|
"artifact": "casan-platform-preview-v{VERSION}.tar.gz",
|
|
"docker_image": "casan-platform:{VERSION} (preview)"
|
|
},
|
|
"enterprise": {
|
|
"level": 4,
|
|
"package_names": ["casan-enterprise", "casan-governed-console"],
|
|
"status": "future",
|
|
"summary": "Enterprise promotion layer for the already implemented governed console building blocks. The edition remains future until managed deployment, lifecycle operations, legal/compliance deliverables and enterprise support controls are verified.",
|
|
"target_users": ["enterprise/internal platform", "multi-project governance", "official governed AI-SDLC console"],
|
|
"extends": "platform",
|
|
"implemented_components": [
|
|
"RBAC (rbac-check.py)",
|
|
"tenant isolation (tenant-store.sh/tenant-paths.sh/tenant-registry-verify.sh/tenant-crypt.sh)",
|
|
"approval workflow (approval-verify.sh/approval-sign.sh/approval-jwt-mint.py)",
|
|
"KMS (vault-kms.sh)",
|
|
"WORM (worm-ledger.py)",
|
|
"kill-switch (kill-switch.sh)",
|
|
"Governed Chat/Prompt Router/Operator/Codegen MVP (packaged in Platform preview)",
|
|
"Agent/Skill/Model selection MVP (packaged in Platform preview)",
|
|
"Evidence Pack Viewer (packaged in Platform preview)"
|
|
],
|
|
"pending_components": ["managed enterprise deployment evidence", "policy-versioning UI", "HA/DR/SLA", "external security assessment", "commercial support and compliance pack"],
|
|
"includes": ["packages/casan-enterprise"],
|
|
"artifact": "casan-enterprise-preview-v{VERSION}.tar.gz",
|
|
"docker_image": "casan-enterprise:{VERSION} (future)"
|
|
}
|
|
},
|
|
"bundles": {
|
|
"core": {"builds": ["core"], "status": "implemented"},
|
|
"devkit": {"builds": ["core", "devkit"], "status": "implemented"},
|
|
"platform": {"builds": ["core", "devkit", "platform"], "status": "preview"},
|
|
"all-in-one-demo": {"builds": ["core", "devkit", "platform", "apps/okr/domain", "backend", "frontend", "docs/output/casan", "package.json", "package-lock.json", "Dockerfile.backend", "Dockerfile.frontend", "docker-compose.prod.yml"], "status": "implemented", "note": "Full runnable snapshot: harness + OKR app (backend/frontend) + OKR demo domain + latest evidence, for demo/training. The traceability gate needs the app source, so it is bundled here."},
|
|
"enterprise": {"builds": ["enterprise"], "status": "future", "note": "Refused by package-release.sh — Level 4 is structure-only; no fake-complete artifact."}
|
|
}
|
|
}
|