20 Commits
Author SHA1 Message Date
e3edcc8afa feat: v2.3.0 add interactive platform selection to init (#38)
* feat: add interactive platform selection to init

* chore: remove completed OpenSpec artifacts

* chore: remove implemented design note

* fix: protect init lifecycle from unsafe config paths

* fix: support clearing init platforms from CLI

* docs: retire config command from repository rules

* docs: align init lifecycle and clear-platform contracts

* docs: keep repository guidance current-state focused

* docs: limit cleanup to repository-native documents

* docs: preserve historical version notes

---------

Co-authored-by: MerlinH <merlinh221@gmail.com>
2026-07-31 18:54:10 +10:00
c92b46ad65 feat: harden init routing and generated lifecycle (#33)
* feat: harden init routing and generated lifecycle

* test: align restored coverage with platform routing

* docs: translate localized uninstall guidance

* test: complete init routing and lifecycle coverage

* docs: record completed OpenSpec tasks

* chore: archive implemented init lifecycle OpenSpec change

* chore: remove OpenSpec configuration

* docs: clarify platform omission reconciliation

---------

Co-authored-by: MerlinH <merlinh221@gmail.com>
2026-07-12 20:48:09 +10:00
Merlin's CatGitHubCopilot Autofix powered by AI <62310815+github-advanced-security[bot]@users.noreply.github.com>MerlinHCopilot Autofix powered by AI <62310815+github-advanced-security[bot]@users.noreply.github.com>
9fa9ac25a4 feat: add workflow eval framework (#32)
* feat: add workflow eval framework

Add workflow evaluation scenarios, rubrics, schemas, and runner scripts for installed Truthmark workflows.

Move research notes under docs/research and migrate tests from Vitest to node:test.

* Potential fix for pull request finding 'CodeQL / Replacement of a substring with itself'

Co-authored-by: Copilot Autofix powered by AI <62310815+github-advanced-security[bot]@users.noreply.github.com>

---------

Co-authored-by: MerlinH <merlinh221@gmail.com>
Co-authored-by: Copilot Autofix powered by AI <62310815+github-advanced-security[bot]@users.noreply.github.com>
2026-06-30 20:57:55 +10:00
3c52f21d90 feat: add static introduction website (#29)
* feat: add static introduction website

* feat: expand static website positioning

* feat: redesign site with original visuals

* docs(readme): add package status badges

* ci: add project readiness automation

* ci: restrict scorecard workflow permissions

* ci: remove duplicate readiness config

* ci: pin workflow actions by sha

* docs: add scorecard badge

---------

Co-authored-by: MerlinH <merlinh221@gmail.com>
2026-06-27 01:15:39 +10:00
15b8bb94e9 chore: prepare Truthmark 2.2.6 (#28)
* feat: add compact truth-doc prose guidance

* chore: prepare Truthmark 2.2.6

* fix: preserve truth doc line discipline

* docs: emphasize ongoing truth curation

* docs(truth): add behavior scenarios to truth docs

---------

Co-authored-by: MerlinH <merlinh221@gmail.com>
2026-06-27 00:05:15 +10:00
7e60fbce68 chore: prepare Truthmark 2.2.5 (#26)
Co-authored-by: MerlinH <merlinh221@gmail.com>
2026-06-22 03:28:02 +10:00
1ae5ee6d15 chore: refresh generated surfaces and release 2.2.4 (#24)
* docs: move localized READMEs to docs and update packaging

* chore: remove OpenSpec preview and Gemini artifacts

* fix: resolve localized README merge artifacts

* chore: rename pt-BR localized README to pt

* chore: refresh generated surfaces and change log for release 2.2.4

* fix: reformat 2.2.4 change log entry

* chore: rename 2.2.4 changelog note

* fix: refresh localized README translations and links

---------

Co-authored-by: MerlinH <merlinh221@gmail.com>
2026-06-21 01:16:10 +10:00
c70b957149 docs: update README quick start and AI workflow examples (#22)
* docs: update README quick start and quick-start workflows

* docs: expand README language support list

* docs: add missing localized README links and files

* docs: update localized READMEs with complete synchronized content

---------

Co-authored-by: MerlinH <merlinh221@gmail.com>
2026-06-20 20:59:05 +10:00
452f5eeafc refactor: simplify Truthmark workflow surfaces (#20)
* refactor: simplify Truthmark workflow surfaces

* fix: limit Preview workflow surfaces to supported hosts

* docs(truthmark): sync diff-friendly truth docs

* fix: prune retired generated surfaces

* fix: prune retired generated workflow surfaces

* docs: update truthmark architecture and runtime behavior notes

* chore: bump version to 2.2.3

---------

Co-authored-by: MerlinH <merlinh221@gmail.com>
2026-06-20 20:14:07 +10:00
fb2c469005 feat: add canonical agent workflow package (#19)
* feat: add Truth Sync intent checklist

* feat: add canonical agent workflow package

Add the .truthmark/agent canonical workflow package, convert duplicated host workflow bodies into adapter/expanded-adapter surfaces, and validate canonical/adapter freshness in Truthmark check.

Refresh generated surfaces and package metadata for Truthmark 2.3.0, with OpenSpec tasks completed and release notes added.

* fix: preserve native workflow skill packages

* docs: record native skill package decision

* fix: drop unused agent workflow package

* chore: remove implemented OpenSpec docs

* chore: release workflow fixes as 2.2.2

* fix: remove agent-visible version markers

* fix: drop generated surface version markers

* feat: capture decision context in Truth Sync

---------

Co-authored-by: MerlinH <merlinh221@gmail.com>
2026-06-18 17:07:40 +10:00
e9cd67f0b5 refactor: remove semantic repository index (#17)
* docs: replace legacy truth path references

* feat: fold contextpack into workflow status

* refactor: remove semantic repository index

* fix: remove vulnerable frontmatter dependency

* feat: broaden truth sync write authorization

* test: restore workflow state regression coverage

---------

Co-authored-by: MerlinH <merlinh221@gmail.com>
2026-06-16 11:03:04 +10:00
32cfafa9c2 chore: refresh npm dependencies (#16)
Co-authored-by: MerlinH <merlinh221@gmail.com>
2026-06-16 00:55:23 +10:00
2dc0da40ff chore: refresh Truthmark to 2.2.0 (#15)
* Split Truthmark product and engineering truth lanes

* chore: align truthmark docs and runtime with lane updates

* chore: bump package version to 2.2.0

* chore: refresh truthmark surfaces for 2.2.0 and document release

* chore: migrate legacy truth docs to engineering legacy path

* chore: remove legacy docs/truth legacy docs from repository

* chore: trim document command prompts to adapter stubs

* chore: customize truth root README guidance per lane

* chore: make doc reviewer guidance lane-specific and helper-rendered

* fix: remove duplicate check lane-classification render in evidence gate

* fix: make realize doc example lane-agnostic to product and engineering

* feat: separate product and engineering truth lanes

* test: restore workflow surface coverage

* Fix workflow lane prompt boundaries

* test: guard read-only generated surface wording

* Fix manual Realize lane guidance

* fix: harden route relationship diagnostics

Validate reciprocal product and engineering route links, gate missing product-link review diagnostics on product evidence, and reject duplicate route entries with divergent relationship metadata.

* fix: merge duplicate route relationships

Allow repeated route entries for the same truth document, kind, and lane to contribute additive relationship metadata. Keep hard validation errors for kind and lane conflicts and emit merged relationships in RouteMap output.

* fix: make route relationships local

Treat realized_by and realizes metadata as route-local navigation edges. Validate target existence and lane compatibility without requiring reciprocal declarations, and document the chosen semantics.

---------

Co-authored-by: MerlinH <merlinh221@gmail.com>
2026-06-16 00:54:46 +10:00
7e68f5d216 docs: polish localized READMEs (#14)
* docs: polish localized readmes

* docs: remove stale future and research notes

---------

Co-authored-by: MerlinH <merlinh221@gmail.com>
2026-06-13 05:02:17 +10:00
a083b703fa feat: add Truthmark health scorecard and bounded workflow contracts (#13)
* feat: add OpenSpec-driven workflow state

* docs: plan generated playbooks workflow contract

* feat: add truth health scorecard

Release Truthmark 2.1.0 with check JSON scorecard output.

Archive the completed OpenSpec pass 4 scorecard change and update generated truth surfaces.

* fix: unblock truthmark scorecard review

- restore and update coverage for scorecard/evidence/workflow behavior
- make truthmark-sync select a cheap local base when --base is omitted
- report malformed evidence YAML blocks as diagnostics instead of throwing

* fix: tighten workflow boundaries

* fix: fail closed when sync has no comparison base

* fix: tighten truth health review coverage

- only parse fenced YAML evidence blocks with top-level evidence markers
- convert coverage fixtures to valid v2 config and assert non-vacuous diagnostics
- update Truthmark truth docs for source traceability and workflow-state tests

* docs: clarify source traceability diagnostics

* docs: harden optional CLI workflow boundary

* docs: clarify product boundary is repo-local

* fix: bound truthmark workflow fallback behavior

- make live workflow preflight use the one-call instructions contract
- keep missing-CLI fallback bounded for Sync, Document, Structure, and Realize
- add routing and generated-surface coverage plus refreshed host surfaces

* test: cover no-cli workflow fallback bounds

- assert route-first fallback wording in generated workflow surfaces
- clarify progressive-disclosure support files are conditional
- align overview docs with bounded no-CLI behavior

* docs: route workflow eval coverage

* fix: remove workflow instructions preflight

* fix: remove stale workflow preflight wording

* fix: remove generic workflow validation blocks

* fix: avoid duplicated markdown context JSON

* fix: keep workflow status manifest-only

* docs: align truth docs with v2 hierarchy

---------

Co-authored-by: MerlinH <merlinh221@gmail.com>
2026-06-13 04:09:45 +10:00
aa6442bba9 docs: align truth docs with templates (#12)
* docs: align truth docs with templates

* docs: clarify truth template comment guidance

---------

Co-authored-by: MerlinH <merlinh221@gmail.com>
2026-05-31 22:56:16 +10:00
9e330a0fd3 fix(cli): fail on error diagnostics (#11)
* fix(cli): fail on error diagnostics

* chore: release 1.6.1

* feat(init): refresh truth doc templates

* fix(init): preserve custom template preambles

* ci: limit GitHub token permissions

* ci: update setup-node action

---------

Co-authored-by: MerlinH <merlinh221@gmail.com>
2026-05-31 00:35:18 +10:00
e5a586a420 chore: prune unused Truthmark surfaces (#10)
Co-authored-by: MerlinH <merlinh221@gmail.com>
2026-05-28 22:12:15 +10:00
fcfd5f7adc feat: add Truthmark Portal workflow surfaces (#8)
* fix: harden workflow helper manifests and reports

* docs: add helper script portability design

* fix: reject failed helper statuses in completed reports

* fix: align helper report sections metadata

* fix: preserve sync helper statuses in parser

* test: harden helper validator negatives

* feat: add Copilot and Gemini Truthmark surfaces

- generate Copilot and Gemini workflow skill packages with helper manifests
- add Gemini subagent surfaces and validate helper CLI plumbing
- update README/docs for helper-package support

Verification: npm run check

* docs: simplify README workflow surface overview

Replace long generated file lists with conceptual layers and Mermaid architecture diagrams across localized READMEs.

Verification: node dist/main.js check --json; npm run package:check

* docs: show agent CLI feedback loop in README diagram

Clarify that host-native agent workflows can call the installed Truthmark CLI for validation, indexing, and helper checks.

Verification: node dist/main.js check --json; npm run package:check

* fix: wrap validate JSON output in command envelope

Return helper validation results under data.validation for --json output while preserving the existing human-readable validate output.

Verification: npm run check; truthmark check/index JSON diagnostics.

* fix: clarify helper validation status reporting

Add explicit helper-status policy to Truth Sync and Truth Document surfaces so standalone Copilot prompts and Gemini commands only report ran/passed after the installed CLI validator succeeds.

Update README and workflow docs to describe the shared installed-CLI validator contract instead of saying standalone surfaces mark helper packages unavailable.

Verification: npm run check; npm run package:check; truthmark check/index JSON diagnostics.

* fix: normalize helper status ids during validation

Parse helper status entries with the same regex used for syntax validation and compare captured helper IDs against required helpers.

Adds regressions for extra whitespace after helper bullets in Truth Sync and Truth Document reports.

Verification: npm run check; npm run package:check; truthmark check/index JSON diagnostics.

* fix: parse write lease YAML structurally

* chore: bump version to 1.5.0

* docs: include validate in repo CLI boundary

* fix: enforce workflow report validator contracts

* fix: require manual review files in blocked sync reports

* feat: add Truthmark Portal workflow surfaces

- add Portal workflow guidance, config/defaults, and generated provider surfaces
- cover Portal config path boundaries and generated surface contracts
- clarify project-local policy docs are optional and config-driven

---------

Co-authored-by: MerlinH <merlinh221@gmail.com>
2026-05-28 14:39:21 +10:00
17ed1599a3 feat: add workflow helper validators and host-native surfaces (#7)
* fix: harden workflow helper manifests and reports

* docs: add helper script portability design

* fix: reject failed helper statuses in completed reports

* fix: align helper report sections metadata

* fix: preserve sync helper statuses in parser

* test: harden helper validator negatives

* feat: add Copilot and Gemini Truthmark surfaces

- generate Copilot and Gemini workflow skill packages with helper manifests
- add Gemini subagent surfaces and validate helper CLI plumbing
- update README/docs for helper-package support

Verification: npm run check

* docs: simplify README workflow surface overview

Replace long generated file lists with conceptual layers and Mermaid architecture diagrams across localized READMEs.

Verification: node dist/main.js check --json; npm run package:check

* docs: show agent CLI feedback loop in README diagram

Clarify that host-native agent workflows can call the installed Truthmark CLI for validation, indexing, and helper checks.

Verification: node dist/main.js check --json; npm run package:check

* fix: wrap validate JSON output in command envelope

Return helper validation results under data.validation for --json output while preserving the existing human-readable validate output.

Verification: npm run check; truthmark check/index JSON diagnostics.

* fix: clarify helper validation status reporting

Add explicit helper-status policy to Truth Sync and Truth Document surfaces so standalone Copilot prompts and Gemini commands only report ran/passed after the installed CLI validator succeeds.

Update README and workflow docs to describe the shared installed-CLI validator contract instead of saying standalone surfaces mark helper packages unavailable.

Verification: npm run check; npm run package:check; truthmark check/index JSON diagnostics.

* fix: normalize helper status ids during validation

Parse helper status entries with the same regex used for syntax validation and compare captured helper IDs against required helpers.

Adds regressions for extra whitespace after helper bullets in Truth Sync and Truth Document reports.

Verification: npm run check; npm run package:check; truthmark check/index JSON diagnostics.

* fix: parse write lease YAML structurally

* chore: bump version to 1.5.0

* docs: include validate in repo CLI boundary

* fix: enforce workflow report validator contracts

* fix: require manual review files in blocked sync reports

---------

Co-authored-by: Hermes Agent <hermes-agent@users.noreply.github.com>
2026-05-20 11:15:24 +10:00