Skip to content

refactor(templates): unify naming, single-source metadata, honest AI copy#76

Merged
xuyushun441-sys merged 1 commit into
mainfrom
refactor/template-catalog-cleanup
Jun 23, 2026
Merged

refactor(templates): unify naming, single-source metadata, honest AI copy#76
xuyushun441-sys merged 1 commit into
mainfrom
refactor/template-catalog-cleanup

Conversation

@xuyushun441-sys

Copy link
Copy Markdown
Contributor

What & why

Marketplace/catalog cleanup across the 9 templates — prompted by inconsistent naming on the marketplace cards and AI copy that oversold scaffolded features.

Naming

  • Drop the "AI" prefix from displayNames: AI Helpdesk → Helpdesk, AI Project Management → Project Management. AI stays in descriptions/field labels, not the name.
  • Aligned the name across the surfaces that had drifted: manifest.json displayName, config.ts manifest.name, *.app.ts nav label, and every locale translation. (e.g. project's pm.app.ts already said "Project Management" but the en/zh translations overrode it back to "AI …" — the translation wins at runtime.)
  • Reconciled hr name drift (config.ts manifest.name "HR" → "Human Resources").

Single source of truth

Honesty

  • Templates that ship AI as a scaffold no longer market it as delivered:
    • helpdesk — triage is a deterministic baseline (ai_summary = description.slice(0, 280)), not a model.
    • project — the forecasting flow node is a STUB; ai_* seed values are illustrative. Field group relabelled "AI Predictions (scaffolded)".
  • Added docs/ROADMAP.md capturing the AI implementation plan (route AI through the platform model registry instead of raw api.openai.com, degrade honestly when no model is configured, finish one flagship) plus other findings (content over-charter, todo/project overlap, category facet casing).

Not changed

  • Category slugs left as-is: the visible facet-casing inconsistency is a marketplace-UI label-map gap, and changing the hr slug would regress the UI's existing hr → "Human Resources" mapping (noted in the roadmap).

Verification

  • tsc --noEmit passes for the two packages with .ts changes (helpdesk, project).
  • All manifests / package.json parse as valid JSON.
  • No runtime behavior change. Catalog display_name updates on the next publish run (upserted on every publish, not gated by the version number).

🤖 Generated with Claude Code

…ake AI copy honest

Marketplace/catalog cleanup across the 9 templates.

Naming
- Drop the "AI" prefix from displayNames (AI Helpdesk -> Helpdesk, AI Project
  Management -> Project Management); AI stays in descriptions/field labels.
  Applied across manifest displayName, config manifest.name, app nav labels,
  and every locale translation so the catalog card and the installed-app name
  finally agree.
- Reconcile hr app-name drift (config manifest.name "HR" -> "Human Resources").

Single source of truth
- Remove the dead objectstack.marketplace block from every package.json. The
  publish path (scripts/publish-template.mjs) reads objectstack.manifest.json
  only; the package.json copies were unread and still carried the stale
  category:"starter" that #73 removed from the manifests. project keeps
  objectstack.port.

Honesty
- Templates that ship AI as a scaffold no longer market it as delivered.
  helpdesk (deterministic triage baseline) and project (stubbed forecasting,
  illustrative seed values) reworded in manifest/config/README; project's ai_*
  field group relabelled "AI Predictions (scaffolded)".
- Add docs/ROADMAP.md capturing the AI implementation plan (route AI through
  the platform model registry instead of raw api.openai.com, degrade honestly
  when no model is configured, finish one flagship) plus the other findings
  (content over-charter, todo/project overlap, category facet casing).

Category slugs left as-is: the visible facet-casing inconsistency is a
marketplace-UI label-map gap, and changing the hr slug would regress the
UI's existing hr -> "Human Resources" mapping.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@xuyushun441-sys xuyushun441-sys merged commit 8354c1c into main Jun 23, 2026
3 checks passed
@xuyushun441-sys xuyushun441-sys deleted the refactor/template-catalog-cleanup branch June 23, 2026 10:02
xuyushun441-sys added a commit that referenced this pull request Jun 23, 2026
These three templates had bundle changes in #76 (display name / app nav label /
config manifest.name / project's ai_* field group) that only reach the
marketplace as a new sys_package_version. The other six templates are unchanged
(the #76 package.json edits removed a block the publish path never reads), so
they stay at their current versions and 409 no-op on republish.

Also adds the #76 CHANGELOG entry.

Co-authored-by: Jack Zhuang <277994282+os-zhuang@users.noreply.github.com>
Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants