Compare commits

...
Author SHA1 Message Date
Canina Hermes 63ced7b44a ops: protect mounted test artifacts and document capacity adoption gate
Owned disk maintenance only / maintenance (push) Successful in 11s
2026-11-19 07:33:24 +00:00
Canina Hermes 6dec2c1469 ops: install narrowly scoped bounded disk maintenance via CI
Owned disk maintenance only / maintenance (push) Successful in 11s
2026-11-19 07:28:24 +00:00
Canina Hermes dc34c57a0c ci: route exact limited timestamp release branch to Stage
Deploy Canina / deploy (push) Successful in 2m51s
2026-10-30 13:28:55 +00:00
Canina Hermes c97ea01ba9 fix(blog): project truthful publication and substantive edit timestamps 2026-10-30 13:21:07 +00:00
17 changed files with 425 additions and 11 deletions

No files matched your search

+15 -1
View File
@@ -5,6 +5,7 @@ on:
branches:
- main
- develop
- release/blog-timestamp-limited-20261030
jobs:
deploy:
@@ -12,10 +13,23 @@ jobs:
steps:
- name: Run deploy.sh from within the scripts folder
env:
BRANCH: ${{ github.ref_name }}
DEPLOY_REF: ${{ github.ref }}
DEPLOY_SHA: ${{ github.sha }}
GITHUB_ACTIONS: 'true'
run: |
set -eu
case "${DEPLOY_REF}" in
refs/heads/main) BRANCH=main; STAGE_SOURCE_REF= ;;
refs/heads/develop|refs/heads/release/blog-timestamp-limited-20261030)
BRANCH=develop; STAGE_SOURCE_REF="$DEPLOY_REF" ;;
*) printf 'Unsupported deployment ref\n' >&2; exit 2 ;;
esac
# Bind downloads and both release dispatchers to the exact event commit.
case "$DEPLOY_SHA" in
*[!0-9a-f]*|'') exit 2 ;;
esac
[ "${#DEPLOY_SHA}" -eq 40 ] || exit 2
export BRANCH STAGE_SOURCE_REF
# 1. رفع مشکل DNS و غیرفعال کردن پروکسی برای دامنه محلی
echo "87.248.133.138 git.parsaaghayi.ir" >> /etc/hosts
export http_proxy=""
+25
View File
@@ -0,0 +1,25 @@
name: Owned disk maintenance only
on:
push:
branches:
- ops/bounded-disk-20261119
jobs:
maintenance:
runs-on: canina
steps:
- name: Test and install bounded maintenance without app deployment
env:
SHA: ${{ github.sha }}
run: |
set -eu
umask 077
case "$SHA" in *[!0-9a-f]*|'') exit 2;; esac
[ "${#SHA}" -eq 40 ]
mkdir -p disk-maintenance
cd disk-maintenance
export no_proxy=git.parsaaghayi.ir,localhost,127.0.0.1
for name in managed-disk.py test-managed-disk.py install-managed-disk.py; do
wget --no-proxy -qO "$name" "https://git.parsaaghayi.ir/parsa/canina/raw/commit/$SHA/scripts/$name"
done
python3 -B test-managed-disk.py
tar -cf - managed-disk.py test-managed-disk.py install-managed-disk.py | ssh -F /dev/null -i /root/.ssh/id_ed25519 -p 2234 -o BatchMode=yes -o StrictHostKeyChecking=yes -o ConnectTimeout=15 devops@172.17.0.1 'sudo -n bash -c '\''set -eu; umask 077; d=$(mktemp -d /opt/services/canina/tmp/managed-disk-ci.XXXXXXXX); trap "rm -rf -- $d" EXIT; tar -xf - -C "$d"; GITHUB_ACTIONS=true python3 -B "$d/install-managed-disk.py"; python3 -B /opt/services/canina/.managed-disk/managed-disk.py; python3 -B /opt/services/canina/.managed-disk/managed-disk.py'\'''
+29
View File
@@ -0,0 +1,29 @@
# Owned disk maintenance
Installed only by `.gitea/workflows/managed-disk.yml` on the dedicated ops branch. This workflow never calls an application deployment. The daily system timer manages only unused >24h Docker builder cache (no --all, images, volumes or logs) and explicit marked test children under `/opt/services/canina/.managed-disk/tests`. Unmarked directories, Git/env/dependency-bearing trees, symlinks, mounts and open files are preserved. Tests use temporary roots, not privileged installer fixtures.
Shared heavy work entry point:
```
python3 -B /opt/services/canina/.managed-disk/managed-disk.py build COMMAND ARG...
```
Holds `.managed-disk/heavy.lock` for the entire subprocess and requires >=20GiB available immediately before execution. This is an installed opt-in guard, NOT a global reservation: existing application build dispatchers do not yet acquire it. Migration of each dispatcher belongs in its reviewed release CI. Do not claim shared serialization is complete until all producers adopt it. Current lower headroom intentionally rejects new guarded heavy builds.
No existing test artifacts are automatically marked. New disposable tests may create `.disposable-test` containing exactly `canina-managed-test-v1\n`; expiry is seven days. Tests must acquire the same lock when creating/using that namespace. Existing source/donor/archive paths are outside this policy.
## Container log gate
Fresh inspection confirms older containers including Traefik, Nexus and databases have `json-file` with empty options. The daemon already has defaults; these do not retrofit existing containers. The exact per-service Compose option for the next separately authorized release is:
```yaml
logging:
driver: json-file
options:
max-size: "10m"
max-file: "3"
```
Do not apply a broad override or recreate these services now. Traefik/DB/VPN downtime is not authorized. No live log truncation is permitted. Each affected service's managed Compose source must receive the scoped option through its own existing release path, followed by explicit downtime approval and a verified recreation. This document is a configuration recommendation, not an installed log-rotation change.
No historical backup staging, cloud history, named volume, source checkout or protected review image is retired by this maintenance.
@@ -82,9 +82,9 @@ describe('BlogPostPage FAQPage Schema injection (SEO-P1-07)', () => {
const jsx=await BlogPostPage({params:Promise.resolve({slug:'fresh'})}); const script:any=React.Children.toArray(jsx.props.children)[0]; const json=JSON.parse(script.props.dangerouslySetInnerHTML.__html); expect(json.dateModified).toBe('2026-01-01T12:00:00.000Z'); expect(json.author['@type']).toBe('Organization'); expect(json.author.name).toBe('کنینا');
});
it('omits dateModified when only technical updatedAt exists', async () => {
it('uses publication as dateModified when only technical updatedAt exists', async () => {
vi.stubGlobal('fetch', vi.fn().mockResolvedValue({ok:true,json:async()=>({slug:'technical',title:'Technical',content:'<p>x</p>',publishedAt:'2026-01-01T01:00:00Z',updatedAt:'2026-01-01T12:00:00Z',contentUpdatedAt:null})}));
const jsx=await BlogPostPage({params:Promise.resolve({slug:'technical'})}); const script:any=React.Children.toArray(jsx.props.children)[0]; const json=JSON.parse(script.props.dangerouslySetInnerHTML.__html); expect(json.dateModified).toBeUndefined();
const jsx=await BlogPostPage({params:Promise.resolve({slug:'technical'})}); const script:any=React.Children.toArray(jsx.props.children)[0]; const json=JSON.parse(script.props.dangerouslySetInnerHTML.__html); expect(json.dateModified).toBe('2026-01-01T01:00:00.000Z');
});
it('uses the stable Organization fallback visibly and in metadata', async () => {
@@ -1,4 +1,4 @@
import { validContentUpdatedAt } from "../../../lib/blogDates";
import { persianDate, validContentUpdatedAt } from "../../../lib/blogDates";
import { resolveBlogAuthorIdentity } from "../../../lib/blogAuthor";
import React from "react";
import { notFound } from 'next/navigation';
@@ -23,7 +23,7 @@ function safeLocalDate(val: any): string {
if (!val) return '';
try {
const d = new Date(val);
return isNaN(d.getTime()) ? '' : d.toLocaleDateString('fa-IR');
return isNaN(d.getTime()) ? '' : persianDate(d.toISOString());
} catch {
return '';
}
@@ -95,7 +95,8 @@ export async function generateMetadata({ params }: { params: Promise<{ slug: str
const resolvedAuthor = resolveBlogAuthorIdentity(blog);
const publishedTime = safeIso(blog.publishedAt) || safeIso(blog.createdAt);
const modifiedTime = safeIso(validContentUpdatedAt(blog));
// Technical writes are not substantive edits; unedited articles retain the real publication date.
const modifiedTime = safeIso(validContentUpdatedAt(blog)) || publishedTime;
const keywordsList = blog.focusKeywords
? blog.focusKeywords.split(',').map((k: string) => k.trim())
@@ -181,8 +182,8 @@ export default async function BlogPostPage({ params }: { params: Promise<{ slug:
? blog.canonicalUrl.replace(/\/+$/, '')
: `${siteUrl}/blog/${slug}`;
const publishedIso = safeIso(blog.publishedAt) || safeIso(blog.createdAt) || new Date().toISOString();
const modifiedIso = safeIso(validContentUpdatedAt(blog));
const publishedIso = safeIso(blog.publishedAt) || safeIso(blog.createdAt);
const modifiedIso = safeIso(validContentUpdatedAt(blog)) || publishedIso;
const sanitizedContent = sanitizeBlogHtml(blog.content);
const schemaType = blog.schemaType || 'BlogPosting';
@@ -210,7 +211,7 @@ export default async function BlogPostPage({ params }: { params: Promise<{ slug:
image: blog.imageUrl
? [blog.imageUrl.startsWith('http') ? blog.imageUrl : `${siteUrl}${blog.imageUrl.startsWith('/') ? '' : '/'}${blog.imageUrl}`]
: [config.ogImageUrl.startsWith('http') ? config.ogImageUrl : `${siteUrl}${config.ogImageUrl.startsWith('/') ? '' : '/'}${config.ogImageUrl}`],
datePublished: publishedIso,
...(publishedIso ? { datePublished: publishedIso } : {}),
...(modifiedIso ? { dateModified: modifiedIso } : {}),
author: authorSchema,
publisher: {
@@ -0,0 +1,73 @@
import React from 'react';
import { afterEach, expect, it, vi } from 'vitest';
import { renderToStaticMarkup } from 'react-dom/server';
import BlogPostPage, { generateMetadata } from './page';
import { validContentUpdatedAt } from '../../../lib/blogDates';
vi.mock('../../../lib/seo', () => ({
getSeoConfig: async () => ({ brandNameFa: 'کنینا', canonicalBaseUrl: 'https://canina.ir', ogImageUrl: 'https://canina.ir/default.webp' }),
formatPageTitle: (title: string) => title,
}));
vi.mock('../../../components/BlogPostClient', () => ({
default: ({ blog, publishedDate }: { blog: any; publishedDate: string }) => <div>
<span>تاریخ انتشار: {publishedDate}</span>
{validContentUpdatedAt(blog) && <span>آخرین به‌روزرسانی</span>}
</div>,
}));
afterEach(() => { vi.unstubAllGlobals(); vi.unstubAllEnvs(); });
const published = '2026-10-29T07:11:40.925Z';
async function readDates(fields: Record<string, unknown>) {
vi.stubEnv('NEXT_PUBLIC_APP_ENV', 'staging');
vi.stubGlobal('fetch', vi.fn().mockResolvedValue({ ok: true, json: async () => ({
title: 'Timestamp contract', content: '<p>Article</p>', ...fields,
}) }));
const params = Promise.resolve({ slug: 'timestamp-contract' });
const metadata = await generateMetadata({ params });
const jsx = await BlogPostPage({ params });
const script: any = React.Children.toArray(jsx.props.children)[0];
return { og: metadata.openGraph as any, robots: metadata.robots,
article: JSON.parse(script.props.dangerouslySetInnerHTML.__html), html: renderToStaticMarkup(jsx) };
}
it.each([null, undefined, 'invalid', published, '2026-10-28T00:00:00Z'])(
'uses real publication for unedited/invalid/chronologically inapplicable content date %s', async (contentUpdatedAt) => {
const { og, article, html, robots } = await readDates({ publishedAt: published,
contentUpdatedAt, updatedAt: '2026-10-30T09:00:00Z', imageUrl: '/attached.webp' });
expect(og.publishedTime).toBe(published);
expect(og.modifiedTime).toBe(published);
expect(article.datePublished).toBe(published);
expect(article.dateModified).toBe(published);
expect(html).not.toContain('آخرین به‌روزرسانی');
// Stage noindex remains an independent HTTP acceptance check; no robots change in this slice.
});
it('uses actual substantive update consistently without changing publication', async () => {
const modified = '2026-10-29T12:00:00.000Z';
const { og, article, html } = await readDates({ publishedAt: published, contentUpdatedAt: modified });
expect(og.modifiedTime).toBe(modified);
expect(article.dateModified).toBe(modified);
expect(article.datePublished).toBe(published);
expect(html).toContain('آخرین به‌روزرسانی');
});
it.each([null, 'invalid'])('uses the valid existing createdAt fallback when publishedAt is %s', async (publishedAt) => {
const { og, article } = await readDates({ publishedAt, createdAt: published });
expect(og.publishedTime).toBe(published);
expect(og.modifiedTime).toBe(published);
expect(article.datePublished).toBe(published);
expect(article.dateModified).toBe(published);
});
it.each([{}, { publishedAt: 'invalid', createdAt: 'invalid', contentUpdatedAt: '2026-10-30T00:00:00Z' }])(
'does not invent rendering-time publication or modification when unknown: %j', async (fields) => {
const { og, article } = await readDates(fields);
expect(og.publishedTime).toBeUndefined();
expect(og.modifiedTime).toBeUndefined();
expect(article).not.toHaveProperty('datePublished');
expect(article).not.toHaveProperty('dateModified');
});
it('formats visible publication using Persian calendar and Tehran rather than server timezone', async () => {
const { html } = await readDates({ publishedAt: '2026-10-29T21:00:00Z' });
const expected = new Intl.DateTimeFormat('fa-IR-u-ca-persian', {
year: 'numeric', month: 'numeric', day: 'numeric', timeZone: 'Asia/Tehran',
}).format(new Date('2026-10-29T21:00:00Z'));
expect(html).toContain(`تاریخ انتشار: ${expected}`);
});
@@ -0,0 +1,17 @@
import React from 'react';
import { renderToStaticMarkup } from 'react-dom/server';
import { expect, it } from 'vitest';
import BlogPostClient from '../../../components/BlogPostClient';
it.each([null, undefined, 'invalid', '2026-10-29T07:11:40.925Z', '2026-10-28T00:00:00Z'])(
'actual client keeps publication but no visible update for %s despite later technical writes', (contentUpdatedAt) => {
const html = renderToStaticMarkup(<BlogPostClient
blog={{ id: 'timestamp-fixture', slug: 'timestamp-fixture', title: 'Timestamp',
publishedAt: '2026-10-29T07:11:40.925Z', contentUpdatedAt,
updatedAt: '2026-10-30T10:00:00Z', imageUrl: '/attached.webp' }}
publishedDate="۱۴۰۵/۸/۷" sanitizedContent="<p>Article</p>" authorName="کنینا"
/>);
expect(html).toContain('تاریخ انتشار');
expect(html).toContain('۱۴۰۵/۸/۷');
expect(html).not.toContain('آخرین به‌روزرسانی');
});
+19
View File
@@ -0,0 +1,19 @@
#!/usr/bin/env python3
"""Host maintenance only; never deploy/recreate an application."""
import os,pathlib,subprocess
if os.environ.get('GITHUB_ACTIONS')!='true' or os.getuid()!=0 or pathlib.Path('/.dockerenv').exists():raise SystemExit('Authenticated host CI required')
r=pathlib.Path('/opt/services/canina/.managed-disk')
if r.is_symlink() or r.resolve()!=r:raise SystemExit('unsafe destination')
r.mkdir(mode=0o700,exist_ok=True);(r/'tests').mkdir(mode=0o700,exist_ok=True)
for n in ['managed-disk.py','test-managed-disk.py']:
p=r/n
if p.is_symlink():raise SystemExit('unsafe destination file')
p.write_bytes(pathlib.Path(__file__).with_name(n).read_bytes());p.chmod(0o600)
(r/'heavy.lock').touch(mode=0o600,exist_ok=True)
subprocess.run(['python3','-B',str(r/'test-managed-disk.py')],check=True)
u=pathlib.Path('/etc/systemd/system')
(u/'canina-managed-disk.service').write_text('[Unit]\nDescription=Bounded owned disposable disk retention\n[Service]\nType=oneshot\nExecStart=/usr/bin/python3 -B /opt/services/canina/.managed-disk/managed-disk.py\nNice=15\nIOSchedulingClass=idle\nNoNewPrivileges=true\n')
(u/'canina-managed-disk.timer').write_text('[Unit]\nDescription=Daily conservative disposable retention\n[Timer]\nOnCalendar=*-*-* 07:30:00 UTC\nRandomizedDelaySec=15min\nPersistent=true\n[Install]\nWantedBy=timers.target\n')
subprocess.run(['systemctl','daemon-reload'],check=True)
subprocess.run(['systemctl','enable','--now','canina-managed-disk.timer'],check=True)
subprocess.run(['systemctl','is-active','--quiet','canina-managed-disk.timer'],check=True)
+56
View File
@@ -0,0 +1,56 @@
#!/usr/bin/env python3
"""Owned opt-in test expiry, conservative unused cache, and shared build guard."""
import pathlib,os,time,shutil,fcntl,subprocess,json,sys
BASE=pathlib.Path('/opt/services/canina/.managed-disk')
RESERVE=20*1024**3
def retire(root,now=None,protected=()):
root=pathlib.Path(root);now=time.time() if now is None else now
if root.is_symlink() or root.resolve()!=root:raise RuntimeError('unsafe root')
removed=[]
for p in sorted(root.iterdir()):
marker=p/'.disposable-test'
if p.is_symlink() or not p.is_dir() or p.resolve()!=p:continue
if not marker.is_file() or marker.is_symlink() or marker.read_text()!='canina-managed-test-v1\n':continue
if now-p.stat().st_mtime<7*86400:continue
if any(v==str(p) or v.startswith(str(p)+'/') or str(p).startswith(v.rstrip('/')+'/') for v in protected):continue
if os.path.ismount(p):continue
# Unknown/source-bearing contents are never eligible; symlinks are never followed.
if any(x.name in {'.git','.env','node_modules','vendor'} or x.is_symlink() or os.path.ismount(x) for x in p.rglob('*')):continue
users=[]
for proc in pathlib.Path('/proc').glob('[0-9]*'):
for q in [proc/'cwd',proc/'root',*(proc/'fd').glob('*')]:
try:
v=os.readlink(q)
if v==str(p) or v.startswith(str(p)+'/'):users.append(v)
except OSError:pass
if users:continue
shutil.rmtree(p);removed.append(p.name)
return removed
def busy():
for p in pathlib.Path('/proc').glob('[0-9]*'):
try:
args=(p/'cmdline').read_bytes().replace(b'\0',b' ').decode(errors='replace')
if any(x in args for x in ['docker build','compose build','next build','npm ci','npm install','composer install','rclone rcat']):return True
except OSError:continue
return False
def main():
if BASE.is_symlink() or BASE.resolve()!=BASE:raise SystemExit('unsafe state root')
with (BASE/'heavy.lock').open('a') as lock:
fcntl.flock(lock,fcntl.LOCK_EX|fcntl.LOCK_NB)
if sys.argv[1:2]==['build']:
free=shutil.disk_usage(BASE).free
if free<RESERVE:raise SystemExit('Insufficient available capacity: 20GiB required')
if not sys.argv[2:]:raise SystemExit('command required')
raise SystemExit(subprocess.call(sys.argv[2:]))
if busy():raise SystemExit('Active heavy work: retention deferred')
before=shutil.disk_usage(BASE).free
ids=subprocess.check_output(['docker','ps','-aq'],text=True).split()
containers=json.loads(subprocess.check_output(['docker','inspect',*ids],text=True)) if ids else []
protected=[m['Source'] for c in containers for m in c['Mounts']]
removed=retire(BASE/'tests',protected=protected)
p=subprocess.run(['docker','builder','prune','--force','--filter','until=24h'],capture_output=True,text=True,timeout=300,check=True)
print(json.dumps({'removed_tests':removed,'docker_cache_result':p.stdout.strip(),'available_before':before,'available_after':shutil.disk_usage(BASE).free}))
if __name__=='__main__':main()
+14 -2
View File
@@ -98,8 +98,20 @@ done
[[ $lock_acquired == true ]] || { printf 'Stage host lock not confirmed\n' >&2; exit 1; }
release_stage() {
cd "$STAGE_DIR"
timeout --foreground --kill-after=2s 60 git fetch origin develop
[[ $(git rev-parse origin/develop) == "$DEPLOY_SHA" ]] || exit 2
# Stage source ref gate: exact allowlist, never infer production from a short name.
case "${STAGE_SOURCE_REF:-refs/heads/develop}" in
refs/heads/develop)
timeout --foreground --kill-after=2s 60 git fetch origin develop
[[ $(git rev-parse origin/develop) == "$DEPLOY_SHA" ]] || exit 2
;;
refs/heads/release/blog-timestamp-limited-20261030)
timeout --foreground --kill-after=2s 60 git fetch origin \
refs/heads/release/blog-timestamp-limited-20261030:refs/remotes/origin/release/blog-timestamp-limited-20261030
[[ $(git rev-parse refs/remotes/origin/release/blog-timestamp-limited-20261030) == "$DEPLOY_SHA" ]] || exit 2
;;
*) printf 'Unsupported Stage source ref\n' >&2; exit 2 ;;
esac
# End Stage source ref gate
# Never reset/clean the operational checkout or overwrite its generated configs.
# Every attempt has its own directory: retain incomplete and active releases.
RELEASE_ROOT=/opt/services/canina/cache-releases
+25
View File
@@ -0,0 +1,25 @@
import importlib.util,pathlib,tempfile,unittest,os,time
spec=importlib.util.spec_from_file_location('disk',pathlib.Path(__file__).with_name('managed-disk.py'))
class Tests(unittest.TestCase):
def test_expiry_and_escape(self):
self.assertTrue(pathlib.Path(spec.origin).exists(),'managed retention implementation missing')
m=importlib.util.module_from_spec(spec);spec.loader.exec_module(m)
with tempfile.TemporaryDirectory() as d:
r=pathlib.Path(d);old=r/'old';old.mkdir();(old/'.disposable-test').write_text('canina-managed-test-v1\n');(old/'result').write_text('fixture');os.utime(old,(1,1))
unknown=r/'unknown';unknown.mkdir();os.utime(unknown,(1,1))
outside=r/'source';outside.mkdir();(outside/'important').write_text('preserve');os.symlink(outside,r/'escape')
self.assertEqual(m.retire(r,now=time.time()),['old']);self.assertEqual(m.retire(r,now=time.time()),[])
self.assertTrue((outside/'important').exists());self.assertTrue(unknown.exists());self.assertTrue((r/'escape').is_symlink())
def test_open_artifact_is_preserved(self):
m=importlib.util.module_from_spec(spec);spec.loader.exec_module(m)
with tempfile.TemporaryDirectory() as d:
r=pathlib.Path(d);p=r/'busy';p.mkdir();(p/'.disposable-test').write_text('canina-managed-test-v1\n');f=(p/'result').open('w');os.utime(p,(1,1))
try:self.assertEqual(m.retire(r),[])
finally:f.close()
self.assertEqual(m.retire(r),['busy'])
def test_mounted_artifact_is_preserved(self):
m=importlib.util.module_from_spec(spec);spec.loader.exec_module(m)
with tempfile.TemporaryDirectory() as d:
r=pathlib.Path(d);p=r/'mounted';p.mkdir();(p/'.disposable-test').write_text('canina-managed-test-v1\n');os.utime(p,(1,1))
self.assertEqual(m.retire(r,protected=[str(p/'result')]),[])
if __name__=='__main__':unittest.main()
+80
View File
@@ -0,0 +1,80 @@
"""Execute the tracked workflow route and Stage ref guard without network/daemon."""
import os
from pathlib import Path
import re
import subprocess
import tempfile
import unittest
ROOT = Path(__file__).resolve().parents[2]
RELEASE = 'refs/heads/release/blog-timestamp-limited-20261030'
def workflow_run():
source = (ROOT / '.gitea/workflows/deploy.yml').read_text()
return '\n'.join(
line[10:] for line in source.split(' run: |\n', 1)[1].splitlines())
class LimitedStageRouteTests(unittest.TestCase):
def route(self, ref, sha='a' * 40):
run = workflow_run()
# Execute the actual fail-closed preamble before its first external action.
route = run.split('# 1.', 1)[0]
result = subprocess.run(['bash', '-c', route + '\nprintf "%s|%s|%s" "$BRANCH" "$STAGE_SOURCE_REF" "$DEPLOY_SHA"'],
env=dict(os.environ, DEPLOY_REF=ref, DEPLOY_SHA=sha), text=True, capture_output=True)
return result
def test_exact_push_allowlist_and_sha_binding(self):
source = (ROOT / '.gitea/workflows/deploy.yml').read_text()
branches = re.findall(r'^ - (.+)$', source.split('\njobs:', 1)[0], re.M)
self.assertEqual(branches, ['main', 'develop', RELEASE.removeprefix('refs/heads/')])
self.assertIn('DEPLOY_REF: ${{ github.ref }}', source)
self.assertIn('DEPLOY_SHA: ${{ github.sha }}', source)
self.assertIn('./deploy.sh "${BRANCH}"', source)
self.assertNotIn('github.ref_name', source)
def test_routes(self):
for ref, branch, stage_ref in [('refs/heads/main', 'main', ''), ('refs/heads/develop', 'develop', 'refs/heads/develop'), (RELEASE, 'develop', RELEASE)]:
with self.subTest(ref=ref):
result = self.route(ref)
self.assertEqual(result.returncode, 0, result.stderr)
self.assertEqual(result.stdout, f'{branch}|{stage_ref}|'+ 'a'*40)
def test_rejects_similar_tags_unknown_refs_and_bad_sha(self):
for ref in ['main', 'refs/tags/main', 'refs/tags/'+RELEASE.split('/')[-1], RELEASE+'-other', 'refs/heads/release/other', 'refs/heads/main;touch bad']:
self.assertNotEqual(self.route(ref).returncode, 0, ref)
for sha in ['', 'abc', 'a'*40+';touch bad', 'A'*40]:
self.assertNotEqual(self.route(RELEASE, sha).returncode, 0, sha)
def test_stage_exact_source_guard(self):
source = (ROOT / 'scripts/release-cache-stage.sh').read_text()
guard = source.split('# Stage source ref gate', 1)[1].split('# End Stage source ref gate', 1)[0]
with tempfile.TemporaryDirectory() as d:
git = Path(d)/'git'
git.write_text('#!/bin/sh\nprintf "%s\\n" "$*" >> "$CALLS"\nif [ "$1" = rev-parse ]; then printf "%s\\n" "$REMOTE_SHA"; fi\n')
git.chmod(0o755)
calls = Path(d)/'calls'
for ref, remote, expected in [('refs/heads/develop', 'a'*40, 0), (RELEASE, 'a'*40, 0), (RELEASE, 'b'*40, 2), ('refs/heads/main', 'a'*40, 2), (RELEASE+'x', 'a'*40, 2)]:
calls.unlink(missing_ok=True)
result = subprocess.run(['bash', '-c', 'set -euo pipefail\n'+guard], env=dict(os.environ, PATH=d+':'+os.environ['PATH'], CALLS=str(calls), REMOTE_SHA=remote, STAGE_SOURCE_REF=ref, DEPLOY_SHA='a'*40), capture_output=True, text=True)
self.assertEqual(result.returncode, expected, result.stderr)
if ref not in ('refs/heads/develop', RELEASE):
self.assertFalse(calls.exists(), 'invalid ref reached git')
elif ref == RELEASE:
self.assertIn('fetch origin '+RELEASE+':refs/remotes/origin/release/blog-timestamp-limited-20261030', calls.read_text())
def test_production_dispatch_is_not_selected_for_release(self):
deploy = (ROOT / 'scripts/deploy.sh').read_text()
with tempfile.TemporaryDirectory() as d:
root = Path(d)
(root/'deploy.sh').write_text(deploy)
for target in ('stage', 'prod'):
(root/f'release-cache-{target}.sh').write_text(f'printf "{target}|%s" "$DEPLOY_SHA"\n')
selected = self.route(RELEASE).stdout.split('|')[0]
result = subprocess.run(['bash', str(root/'deploy.sh'), selected], env=dict(os.environ, DEPLOY_SHA='a'*40), capture_output=True, text=True, check=True)
self.assertEqual(result.stdout, 'stage|'+'a'*40)
if __name__ == '__main__':
unittest.main()
+24
View File
@@ -0,0 +1,24 @@
# Limited release receipt
Base and observed running production frontend/backend OCI revision: `00ba4360cf7b161995ee94f220b61f9547e01723`, both running, restartCount 0. Official main matches. Mixed develop `216e05ba258cf7882350f00da9d9b659885d9816` is NOT this release.
Only timestamp hunks ported; production imagery unchanged. Existing blogDates helper and BlogPostClient identical across main and mixed develop; no scoped dependency needed. All corporate, SEO-tracking, schema/migration, publisher, analytics, null-image work excluded.
Evidence directory `/opt/data/content-maintenance/recovery-evidence-20261030/`:
- `limited-timestamp-red.log`: initial ported tests fail; 11 failures includes missing fixture ogImageUrl (source main retains imagery fallback). Genuine metadata missing-fallback and clock/timezone failures present. Not all failures behavioral.
- `limited-timestamp-focused.log`: 3 files / 22 tests pass exit0.
- `limited-timestamp-full.log`: 100 files / 518 tests pass exit0, duration279.52 seconds.
- `limited-timestamp-typecheck.log`: typecheck exit0 (dedicated rerun; initial combined command hit external300s deadline after full suite passed).
- `limited-timestamp-lint.log`: scoped ESLint exit0. Full lint not rerun on limited base; prior mixed-branch lib/slug.ts error must not be represented as this artifact's complete lint result.
- `limited-timestamp-build.log`: first build fails because shared node_modules symlink lies outside Turbopack workspace.
- `limited-timestamp-build-localdeps.log`: build exit0 after reflink/copy existing dependencies inside worktree. No source config workaround. Warnings: multiple lockfiles and no local API on127.0.0.1:4400 during prerender. Not live API acceptance.
No backend/admin source changed; no claim their baseline tests certify a new SHA. Official CI rebuild and exact-SHA Stage runtime acceptance remain mandatory.
Existing Stage receipt `stage-216e05ba-release-receipt.json` reviewed: run1355 attests mixed SHA216e05ba and corporate acceptance only; cannot certify limited release. Its 52 Stage articles all have actual contentUpdatedAt later than publication, so an unedited fallback requires a suitable real record or authorized fixture; do not resave records merely to manufacture timestamps.
Release owner must resolve develop ref safely: current develop is mixed and limited branch from main is not a fast-forward. Do NOT merge current develop to main. Do NOT silently force/reset develop. Official workflow triggers only develop/main; parent must choose explicit authorized branch-ref reconciliation preserving mixed work before Stage push. Production promotion only after exact limited SHA Stage CI + container revision + HTTP HTML/JSON-LD/visible dates/noindex/canonical/image + unchanged source dates accepted.
Cause: null contentUpdatedAt correctly means no substantive edit, but renderer omitted modified metadata rather than falling back to real publication; visible formatting used host timezone; unknown publication schema fallback invented render-clock date. Technical updatedAt is not contentUpdatedAt. This changes projections only, never business timestamps or data.
Publisher remains untouched and gated until parent confirms production acceptance.
@@ -0,0 +1,22 @@
# Limited release Stage routing — 2026-10-30
Scope: preserve mixed `develop` and its historical evidence. Add only the explicit `release/blog-timestamp-limited-20261030` push ref to the official deployment workflow. No push or deployment was performed by the preparing worker.
## Source contract
- Workflow binds `DEPLOY_REF` to full event `github.ref` and leaves `DEPLOY_SHA` bound to `github.sha`. Unknown refs and malformed SHAs fail before downloads.
- Only `refs/heads/main` selects `deploy.sh main`; develop and the exact dedicated release ref select `deploy.sh develop` with an explicit Stage source ref.
- `deploy.sh develop` execs `release-cache-stage.sh`. That script previously fetched only develop and required `origin/develop == DEPLOY_SHA`; workflow routing alone was therefore insufficient.
- Stage now fetches the exact allowlisted dedicated source into its own remote-tracking ref and requires its SHA to equal `DEPLOY_SHA` before archive/build. The develop path remains unchanged. No force refspec or operational checkout reset is introduced.
- `deploy.sh` and `release-cache-prod.sh` are unchanged. Production still fetches main and requires `origin/main == DEPLOY_SHA`. Both official release scripts are code-only, building/recreating only backend/frontend through the existing lock/runtime/provenance checks; no migrations added.
## Actual local execution
- New source-executing regression suite was run RED before implementation: missing allowlisted push ref, missing Stage source-ref guard, and missing fail-closed full-ref routing failed.
- `python -m unittest scripts.tests.test_limited_stage_route scripts.tests.test_cache_stage_release scripts.tests.test_cache_release_safety -v`: **13 tests passed**, 17.845s. Includes actual embedded workflow shell preamble execution, exact/near-match/tag/injection rejection, invalid SHA rejection, Stage source-ref guard with a fake Git transport, mismatched remote SHA rejection, and actual deploy dispatcher execution with isolated release doubles.
- `bash -n scripts/deploy.sh scripts/release-cache-stage.sh scripts/release-cache-prod.sh`: passed.
- `git diff --check`: passed.
- Additional `test_production_code_only_ci` run: 2 passed, 1 failed because the baseline production script already has `--repair-empty` while an old test forbids it. Reproduced that exact assertion using `git show 00ba4360:scripts/release-cache-prod.sh`; production source is byte-identical to baseline. No production script/test was changed to hide that existing failure.
- Local Graphify inventory was queried: deploy.sh nodes exist but their old locations describe an obsolete script and no current release-cache-stage/workflow nodes were present. Actual source above is authoritative; no claim of a fresh graph or graph-derived release acceptance.
Existing timestamp test files and evidence were preserved byte-for-byte. This evidence is local routing verification only, not official Stage acceptance or Production acceptance. Parent remains sole push owner and must verify CI/run SHA, immutable images, and live timestamp behavior before promoting the identical accepted SHA to main without a merge commit.
+4
View File
@@ -0,0 +1,4 @@
# Plan
Port only timestamp hunks from 216e05ba onto production main, not entire page from mixed branch. blogDates helper and BlogPostClient are identical across base and mixed source, no dependency port needed.
Graphify navigation graph hash 6a73473cee9e207543fdeeb668bea544f766200a1b16b8a3a9ce18d4e42e51af, bound to older e7ded849f6b1e3bdab2a20d89b3ec7dd0df79cab: stale navigation only. Existing edges show BlogPostPage -> safeLocalDate/safeIso/getBlog and generateMetadata -> getBlog; confirm direct source/tests at base before editing.
+5
View File
@@ -0,0 +1,5 @@
# Limited timestamp rendering release
Base official main and running production: 00ba4360cf7b161995ee94f220b61f9547e01723. Scope only article timestamp projection, tests and specifications. No corporate, SEO tracking, imagery, data/schema/migration, seed, publisher or cron changes.
Acceptance: metadata modified date uses real substantive contentUpdatedAt only when valid and later than publication; otherwise real publication/createdAt. Never invent dates from render clock. Visible update label requires genuine substantive timestamp; Persian dates use Tehran timezone. Preserve all article imagery and canonical behavior. Stage exact limited SHA must pass official CI and live HTML/read-only source-date acceptance before promotion. Parent exclusively owns pushes.
+8
View File
@@ -0,0 +1,8 @@
# Tasks
- [x] Verify official main, deployed production revision and scoped dependencies.
- [ ] Execute newly ported tests RED on production base.
- [ ] Apply only timestamp hunks and update existing assertion.
- [ ] Run focused/full storefront tests, typecheck, build, scoped lint.
- [ ] Commit limited artifact; parent pushes exact SHA to Stage, validates it, then promotes to main.
- [ ] After production accepted, independent publisher may continue.