Skip to content

feat: tick-shard TEMPLATE.md prevents recurring path-depth bug #4220

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
AceHack merged 1 commit into from
May 18, 2026
Merged

feat: tick-shard TEMPLATE.md prevents recurring path-depth bug #4220

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
92 changes: 92 additions & 0 deletions docs/hygiene-history/tick-shard-TEMPLATE.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,92 @@
<!--
TEMPLATE for tick shards at docs/hygiene-history/ticks/YYYY/MM/DD/HHMMZ.md

Living outside the walked tree (this file is at docs/hygiene-history/, NOT
docs/hygiene-history/ticks/) so it doesn't trip the schema validator.

================================================================
PATH-DEPTH REFERENCE (the recurring lint failure mode this prevents)
================================================================

Tick shards live 5 directories below docs/, so reaching repo-root
requires SIX (6) levels of ".." — not 4, not 5.

WRONG (lints fail):
../../../../... (4 levels → lands at docs/hygiene-history/ticks/YYYY/)
../../../../../... (5 levels → lands at docs/)
CORRECT:
../../../../../../ (6 levels → lands at repo root)

Copy-paste-ready examples (replace target paths):
../../../../../../.claude/rules/<rule-name>.md
../../../../../../docs/backlog/P1/B-NNNN-<slug>.md
../../../../../../tools/<path>.ts
../../../../../../memory/<path>.md

================================================================
SCHEMA REQUIREMENT (per check-tick-history-shard-schema.ts)
================================================================

First non-empty line MUST be a 6-column pipe-row:

| <ISO 8601 UTC timestamp> | <model id> | <cron sentinel> | <body> | <PR ref> | <observation> |

ISO timestamp's date + hour + minute MUST match the shard's path
(YYYY/MM/DD/) and filename (HHMMZ). Seconds optional.

================================================================
FILENAME REGEX (per check-tick-history-shard-schema.ts lines 33-34)
================================================================

HHMMZ.md (bare; e.g., 2139Z.md)
HHMMZ-<hex>.md (collision suffix; hex = [0-9a-f]+; e.g., 2112Z-b.md)
HHMMSSZ-<hex>.md (seconds-resolution)

NOT VALID: -otto-cli-secondary, -peer, -alt (any chars outside [0-9a-f])

================================================================
VERIFY BEFORE PUSH
================================================================

bun tools/hygiene/check-shard-before-push.ts docs/hygiene-history/ticks/YYYY/MM/DD/HHMMZ.md

================================================================
EXAMPLE FOLLOWS — DELETE THIS COMMENT BLOCK + COPY THE EXAMPLE
================================================================
-->

| 2026-05-18T21:42Z | opus-4-7 / autonomous-loop | de1e7f5d | <one-line body summary> | #NNNN | <terse observation> |

# Tick HHMMZ — YYYY-MM-DD — <optional headline>

## Surface

Otto-CLI primary; autonomous-loop cron tick.

## Refresh

- `gh api rate_limit`: graphql NNNN (tier), reset in NN min
- `git ls-remote origin main`: SHA
- Open PRs of interest: ...

## Substantive work this tick

(Concrete artifact landed OR substantive investigation OR brief-ack with
named bounded-wait. Reference rules / PRs / files via 6-level paths above.)

Example link format:

- See [`.claude/rules/holding-without-named-dependency-is-standing-by-failure.md`](../../../../../../.claude/rules/holding-without-named-dependency-is-standing-by-failure.md)
- Composes with [B-0667](../../../../../../docs/backlog/P1/B-0667-tonal-momentum-equals-meme-emergent-harmonic-coercion-extends-nci-detectable-trajectory-defensive-technology-aaron-mika-2026-05-18.md)

## Counter

Brief-ack counter: STATE (e.g., "#1 with named-dep #4218 CI wait" OR "reset by concrete artifact").

## CronList

de1e7f5d sentinel alive (`* * * * *` recurring; `<<autonomous-loop>>`).

## Visibility-stop

End of tick.
5 changes: 5 additions & 0 deletions docs/hygiene-history/ticks/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -50,6 +50,11 @@ conflicts).

## Shard file schema

Copy-paste-ready scaffold: see [`../tick-shard-TEMPLATE.md`](../tick-shard-TEMPLATE.md)
(lives outside this walked directory so it doesn't trip the schema
validator; carries the path-depth + schema + filename-regex reference
inline as a comment block).

Each shard's first non-empty line MUST be a 6-column pipe-row
matching the validator at
[`tools/hygiene/check-tick-history-shard-schema.ts`](../../../tools/hygiene/check-tick-history-shard-schema.ts):
Expand Down
Loading