docs(workflow): add repo-local authority evidence pack

[hu3mann]

What changed

• add a repo-local workflow authority extraction pack under pm-workflow-pack/
• document the entities, persistence model, legality rules, gates, history surfaces, runtime variants, integration seams, and a repo-local authority verdict
• include explicit negative-evidence searches and scan scope so absence claims remain auditable

Pack contents

• 00-scan-scope-and-method.md
• 01-entity-and-persistence-model.md
• 02-workflow-legality-and-transition-analysis.md
• 03-gates-actions-and-progress.md
• 04-audit-history-and-chronicle.md
• 05-runtime-variants-and-local-split-brain-risks.md
• 06-integration-seams.md
• 07-repo-local-authority-verdict.md
• 99-evidence-index.md

Key findings

• current/ is the active implementation baseline according to build wiring and runtime entrypoints.
• Workflow legality is implemented, but direct mutation paths also exist, so legality enforcement is not uniform across all writers.
• Dependency and blocker handling exists, but blocker views are derived rather than first-class persisted authority.
• Next-action computation exists and is advisory.
• No dedicated decision/progress subsystem, comment subsystem, or chronicle/event-store was found in the scanned repo-local scope.
• clockwork/ remains a legacy/archived path and a local split-brain risk when compared with current/.

Validation

• verified output scope and file set under pm-workflow-pack/
• verified citations are present across 01 through 07
• verified negative-evidence searches are recorded in 99-evidence-index.md
• attempted targeted Gradle tests, but this environment does not have a Java runtime installed

Notes

• This PR is evidence-first and repo-local only. It does not make cross-repo authority claims.
• Unrelated local untracked artifacts were intentionally excluded from the commit.

@codex
@Clauee
@copilot

[Copilot]

Pull request overview

Adds a repo-local “workflow authority evidence pack” under pm-workflow-pack/ to document, with citations and recorded negative-evidence searches, what the repository’s active/current workflow implementation persists, enforces, exposes, and does not contain (within the scanned scope).

Changes:

• Introduces a structured documentation pack covering scan method, entity/persistence model, legality rules, gates/read models, history surfaces, runtime variants/split-brain risks, and integration seams.
• Adds a repo-local authority verdict summarizing what the repo is authoritative for vs. absent (based on the included evidence).
• Adds an evidence index capturing primary citations and explicit negative-evidence search commands/results.

Reviewed changes

Copilot reviewed 9 out of 9 changed files in this pull request and generated 8 comments.

Show a summary per file

File	Description
pm-workflow-pack/00-scan-scope-and-method.md	Defines scan scope, commands used, and the negative-evidence method.
pm-workflow-pack/01-entity-and-persistence-model.md	Documents core entities, schema alignment, and reader/writer surfaces in current/.
pm-workflow-pack/02-workflow-legality-and-transition-analysis.md	Describes legality model, validated transition path, and bypass mutation paths.
pm-workflow-pack/03-gates-actions-and-progress.md	Classifies gates and advisory computations; records absence of decision/progress subsystems.
pm-workflow-pack/04-audit-history-and-chronicle.md	Details transition audit trail, exposed history surfaces, and absence of a chronicle/event store.
pm-workflow-pack/05-runtime-variants-and-local-split-brain-risks.md	Analyzes selector drift and competing runtimes/writers as local split-brain risks.
pm-workflow-pack/06-integration-seams.md	Summarizes MCP tool surface, container/runtime seams, config seams, and plugin/hook surfaces.
pm-workflow-pack/07-repo-local-authority-verdict.md	Provides a consolidated repo-local authority verdict grounded in cited code/schema.
pm-workflow-pack/99-evidence-index.md	Central index of citations plus negative-evidence searches and validation attempts.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

This section treats AGENTS.md as a source of repo-local guidance and cites line ranges, but AGENTS.md is not present in the repository tree in this PR. To keep the evidence pack auditable, either commit AGENTS.md or remove/replace the references/citations to it.

[Copilot]

The evidence index records the working directory as an absolute local path (/Users/hue/...). For portability and to avoid leaking local username details, record this as “run from repo root” (or use a placeholder like <repo-root>) instead.

Suggested change

	Each search below was run from `/Users/hue/code/task-orchestrator`.
	Each search below was run from the repository root (`<repo-root>`).

[Copilot]

This primary source index cites AGENTS.md:124-132, but AGENTS.md is not present in the repository tree in this PR. Either add AGENTS.md to the repo or remove/replace these citations so readers can audit them.

Suggested change

- `AGENTS.md:124-132`

[Copilot]

Negative search N8 includes AGENTS.md in the command/scope and references AGENTS.md:131, but the file is not present in the repository. To keep the negative-evidence trail reproducible, remove AGENTS.md from this search (or commit the file) and adjust the result notes accordingly.

[Copilot]

The “Representative inspection commands” block uses ... placeholders in paths (e.g., current/src/main/kotlin/.../CurrentMain.kt), which makes the commands non-reproducible if copy/pasted. Consider replacing these with the concrete paths used elsewhere in the pack (or explicitly label them as placeholders and point to the exact files).

[Copilot]

The scan scope is anchored to a machine-specific absolute path (/Users/hue/...). This makes the pack less portable and can leak local username details. Consider rewriting this to “run from the repo root” (or a placeholder like <repo-root>) and keep commands/citations repo-relative.

Suggested change

	This pack was produced from repo-local evidence in `/Users/hue/code/task-orchestrator` only.
	This pack was produced from repo-local evidence in this repository (from the repo root) only.

[Copilot]

This pack cites AGENTS.md as an inspected selector, but AGENTS.md is not present in the repository tree in this PR. Either add the file to the repo, or remove/replace the references so readers can audit the cited lines.

Suggested change

- `AGENTS.md`

[Copilot]

This limitation note references AGENTS.md being “untracked in this checkout”, but the file is not present in the repo, so readers cannot verify any later citations to it. Suggest removing this line (and any AGENTS.md citations), or committing AGENTS.md if it is intended to be part of the evidence set.

Suggested change

- `AGENTS.md` is untracked in this checkout, but it was still repo-local and inspected as local guidance, not as higher authority than code.