Skip to content

Commit 2d0f6af

Browse files
jmaglyjmagly
committed
Prepare 2026.5.11 release docs
1 parent e287aef commit 2d0f6af

14 files changed

Lines changed: 327 additions & 83 deletions

File tree

‎.aiwg/release.config‎

Lines changed: 10 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -91,16 +91,21 @@ gates:
9191

9292
# Gate 3: Documentation sync.
9393
# Invokes the `doc-sync` skill (orchestrated) with `code-to-docs` direction
94-
# and a guidance hint pulling in agentic/ markdown as the doc corpus.
94+
# and a guidance hint pulling in all agentic/code sources plus the full
95+
# repository Markdown corpus.
9596
- name: doc-sync
9697
hard_stop: true
9798
invoke_skill: doc-sync
9899
args:
99100
direction: code-to-docs
100-
scope: 'agentic/code/**/*.md docs/**/*.md README.md CLAUDE.md AIWG.md AGENTS.md'
101+
scope: 'agentic/code/** **/*.md'
101102
guidance: |
102-
Audit the docs against the current code. Treat agentic/code/ markdown
103-
(framework READMEs, agent definitions, skill bodies, addon manifests)
103+
Audit the docs against the current implementation. Include every file
104+
under agentic/code/ plus all repository Markdown files because AIWG
105+
capability is primarily documented in skills, agents, commands,
106+
templates, behaviors, rules, manifests, and generated guidance.
107+
Treat agentic/code/ framework READMEs, agent definitions, skill bodies,
108+
addon manifests, command docs, templates, behavior bundles, and rules
104109
as authoritative documentation surfaces that must match the current
105110
implementation. Reconcile drift in:
106111
- command references (CLI handlers vs help text vs CLAUDE.md tables)
@@ -139,7 +144,7 @@ gates:
139144
hard_stop: true
140145
steps:
141146
- id: create-tag
142-
run: 'git tag -a {tag} -m "{tag}"'
147+
run: 'tools/release/cut-tag.sh {version}'
143148
- id: push-origin
144149
run: 'git push origin main --tags'
145150
- id: push-mirror

‎.aiwg/reports/doc-sync-20260525T190000Z.md‎

Lines changed: 70 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,70 @@
1+
# Documentation Drift Report
2+
3+
Generated: 2026-05-25T19:00:00Z
4+
5+
Direction: code-to-docs
6+
7+
Scope: agentic/code/** plus all repository Markdown files
8+
9+
Guidance: include all of agentic/code and all Markdown files because AIWG capability is primarily represented in skills, agents, commands, templates, behaviors, rules, manifests, and generated guidance.
10+
11+
Mode: release-prep audit; manual doc-sync execution because the raw `aiwg doc-sync` command handler is not currently registered and doc-sync is exposed as an AIWG skill workflow.
12+
13+
Package Version: 2026.5.11
14+
15+
## Summary
16+
17+
The release-prep doc-sync pass covered the tracked capability corpus and release documentation surfaces. It found and fixed drift in release configuration, media-curator documentation, README framework counts, release navigation manifests, and the pending 2026.5.11 changelog and announcement artifacts.
18+
19+
## Verified Ground Truth
20+
21+
- `agentic/code/**` is the authoritative capability corpus for frameworks, addons, skills, agents, rules, behaviors, manifests, and generated guidance.
22+
- Repository Markdown count at audit time: 2562 files across `agentic/code`, `docs`, root docs, changelog, and tracked AIWG docs.
23+
- `agentic/code` file count at audit time: 2067 files, including 1547 Markdown files.
24+
- Capability-heavy `agentic/code` agents/skills/commands/templates/behaviors/rules Markdown count at audit time: 1295 files.
25+
- Latest stable release tag before this prep: `v2026.5.10`; target release version: `2026.5.11`.
26+
27+
## Findings and Fixes
28+
29+
| Area | Finding | Resolution |
30+
|---|---|---|
31+
| Release config | Doc-sync gate only covered selected Markdown globs and did not express the requested all-agentic-code/all-Markdown audit scope. | Updated `.aiwg/release.config` scope and guidance to include `agentic/code/**` plus `**/*.md`. |
32+
| Release config | Release gate still templated a raw annotated `git tag` command. | Updated the gate to use `tools/release/cut-tag.sh {version}` so release signing uses the dedicated release key wrapper. |
33+
| System rules | Skill/CLI docs needed to preserve the invariant that raw CLI commands augment skill workflows rather than replacing them. | Updated `cli-secondary` and `RULES-INDEX.md`; filed #1480 for the repo-wide audit. |
34+
| Media curator docs | Generated framework overview did not mention `transcribe-media`, transcript sidecars, or `.aiwg/media/transcripts/`. | Updated `docs/frameworks/media-curator/overview.md` with workflow, skill, tooling, pipeline, and archive-structure coverage. |
35+
| README | Framework count was stale and omitted Knowledge Base from the framework table despite top-level docs listing it as core. | Updated README framework count/table and extension-system framework count. |
36+
| README | Media-curator command examples and summary omitted transcript sidecars. | Added `/transcribe-media` example and transcript-sidecar summary. |
37+
| Release docs | No 2026.5.11 changelog section or announcement existed. | Added `CHANGELOG.md` section and `docs/releases/v2026.5.11-announcement.md`. |
38+
| Release manifests | Release navigation pointed at v2026.5.10 as latest. | Added v2026.5.11 to `docs/releases/_manifest.json` and `docs/_manifest.json`. |
39+
40+
## Open Follow-up from Issue Audit
41+
42+
- #1234 remains open for the full media-curator to research-complete bridge. `transcribe-media` is complete, but REF media templates, timestamp citation policy, citation sidecars, `induct-media`, and discoverability work remain open.
43+
- #1478 remains open because broad time-based media research/citation discovery still returns no direct matches.
44+
- #1479 remains open because `aiwg discover "cargo crate supply chain audit"` still routes to npm-specific supply-chain guidance first.
45+
- #1405 remains open because non-local provider field-validation still requires real sessions in the target providers.
46+
- #1480 remains open for the repo-wide audit that aligns docs, quickrefs, skill bodies, command mirrors, and generated guidance with the skill-first CLI augmentation rule.
47+
48+
## Validation Commands Planned for Release Gate
49+
50+
```bash
51+
npm run check:versions
52+
npm run typecheck
53+
npm run build:cli
54+
npm test
55+
npm run uat
56+
```
57+
58+
## Files Updated
59+
60+
- `.aiwg/release.config`
61+
- `.aiwg/reports/doc-sync-last-run.json`
62+
- `.aiwg/reports/doc-sync-20260525T190000Z.md`
63+
- `CHANGELOG.md`
64+
- `README.md`
65+
- `agentic/code/addons/aiwg-utils/rules/RULES-INDEX.md`
66+
- `agentic/code/addons/aiwg-utils/rules/cli-secondary.md`
67+
- `docs/_manifest.json`
68+
- `docs/frameworks/media-curator/overview.md`
69+
- `docs/releases/_manifest.json`
70+
- `docs/releases/v2026.5.11-announcement.md`

‎.aiwg/reports/doc-sync-last-run.json‎

Lines changed: 44 additions & 33 deletions
Original file line numberDiff line numberDiff line change
@@ -1,54 +1,65 @@
11
{
2-
"timestamp": "2026-05-05T00:30:00Z",
2+
"timestamp": "2026-05-25T19:00:00Z",
33
"direction": "code-to-docs",
4-
"scope": "full repo (src/ + agentic/code/)",
5-
"guidance": "agentic/code/ files treated as authoritative source",
4+
"scope": "agentic/code/** plus all repository Markdown files",
5+
"guidance": "include all of agentic/code and all Markdown files; AIWG capability lives in skills, agents, commands, templates, behaviors, rules, manifests, and generated guidance",
66
"phases": [
77
{
88
"phase": "audit",
9-
"auditors_run": ["cli", "extensions", "frameworks", "agents-skills", "schemas", "crossref"],
10-
"findings_total": 59,
11-
"findings_high": 39,
12-
"findings_medium": 16,
13-
"findings_low": 4
14-
},
15-
{
16-
"phase": "auto-fix-pass-1",
17-
"fixes_applied": 14,
18-
"files_modified": ["CLAUDE.md", "AIWG.md", "README.md"]
9+
"auditors_run": [
10+
"release-config",
11+
"release-docs",
12+
"media-curator-docs",
13+
"readme-framework-counts",
14+
"issue-follow-up-discovery",
15+
"skill-cli-rule"
16+
],
17+
"findings_total": 9,
18+
"findings_high": 2,
19+
"findings_medium": 6,
20+
"findings_low": 1
1921
},
2022
{
21-
"phase": "errata-correction-pass-2",
22-
"fixes_applied": 28,
23+
"phase": "auto-fix",
24+
"fixes_applied": 9,
2325
"files_modified": [
24-
"AIWG.md",
25-
"CLAUDE.md",
26+
".aiwg/release.config",
27+
"CHANGELOG.md",
2628
"README.md",
27-
"docs/cli-reference.md",
28-
"docs/extensions/extension-types.md",
29-
"docs/extensions/overview.md",
30-
"docs/extensions/creating-extensions.md",
31-
"docs/releases/v2026.4.0-announcement.md",
32-
"agentic/code/addons/aiwg-utils/manifest.json",
29+
"docs/_manifest.json",
30+
"docs/frameworks/media-curator/overview.md",
31+
"docs/releases/_manifest.json",
32+
".aiwg/reports/doc-sync-last-run.json",
3333
"agentic/code/addons/aiwg-utils/rules/RULES-INDEX.md",
34-
"src/extensions/commands/definitions.ts"
34+
"agentic/code/addons/aiwg-utils/rules/cli-secondary.md"
3535
],
3636
"files_created": [
37-
"docs/configuration/aiwg-config.md",
38-
"docs/configuration/setup-manifest.md",
39-
".aiwg/reports/doc-sync-20260505T035506Z.md"
37+
".aiwg/reports/doc-sync-20260525T190000Z.md",
38+
"docs/releases/v2026.5.11-announcement.md"
4039
]
4140
}
4241
],
4342
"totals": {
44-
"fixes_applied": 42,
43+
"fixes_applied": 9,
4544
"fixes_remaining": 0,
46-
"files_modified": 11,
47-
"files_created": 3
45+
"files_modified": 9,
46+
"files_created": 2
4847
},
4948
"validation": {
50-
"tsc_noEmit": "clean",
51-
"markdownlint_authored_files": "clean (RULES-INDEX.md has pre-existing pattern violations matching existing entries; CLAUDE.md/AIWG.md/docs/configuration/*.md clean)"
49+
"pending": [
50+
"npm run check:versions",
51+
"npm run typecheck",
52+
"npm run build:cli",
53+
"npm test",
54+
"npm run uat"
55+
]
5256
},
53-
"report": ".aiwg/reports/doc-sync-20260505T035506Z.md"
57+
"report": ".aiwg/reports/doc-sync-20260525T190000Z.md",
58+
"open_follow_up": [
59+
"#1234",
60+
"#1405",
61+
"#1478",
62+
"#1479",
63+
"#1480"
64+
]
5465
}

‎.claude-plugin/marketplace.json‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@
66
},
77
"metadata": {
88
"description": "AIWG - Modular agentic framework for SDLC, marketing automation, and workflow orchestration. 200+ agents, 67+ CLI commands, 400+ deployable agent/skill/command/rule artifacts.",
9-
"version": "2026.5.10",
9+
"version": "2026.5.11",
1010
"homepage": "https://aiwg.io",
1111
"repository": "https://github.com/jmagly/aiwg",
1212
"documentation": "https://docs.aiwg.io",

‎CHANGELOG.md‎

Lines changed: 59 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,8 +7,66 @@ and this project uses [Calendar Versioning (CalVer)](https://calver.org/) with n
77

88
## [Unreleased]
99

10+
## [2026.5.11] - 2026-05-25 — "Provider detection, local issue sync, and media transcript prep"
11+
12+
This patch release hardens AIWG's cross-provider workflow plumbing, adds local issue-tracker synchronization paths, and documents the current code-to-docs audit before the next stable tag. It also ships the first concrete time-based media primitive while keeping the larger research handoff work explicit as follow-up scope.
13+
14+
### Why this matters to users
15+
16+
| What changed | What it gives you |
17+
|---|---|
18+
| **Codex-aware provider detection** | Mixed Claude/Codex workspaces now prefer the active Codex runtime where appropriate, so refresh and regenerate flows target the right provider files. |
19+
| **Local issue sync workflows** | Projects can import/export local issue stores, run live tracker sync, and document conflict handling without guessing which issue backend is active. |
20+
| **Media transcript sidecars** | Media-curator can now surface a transcript sidecar workflow for acquired audio/video, including source metadata, hashes, timestamps, and degraded plans when local STT tooling is missing. |
21+
| **Security and supply-chain scaffolding** | Security-engineering gained CI emitters, banned-API scaffolds, DFIR readiness routing, and supply-chain audit documentation. |
22+
| **Release and docs hygiene** | Release config now records the broad doc-sync scope for all agentic/code sources plus repository Markdown, and release tags are routed through the dedicated signing wrapper. |
23+
24+
### Added
25+
26+
- Local issue import/export and live sync workflows, plus documentation for migration, conflicts, backups, and credentials.
27+
- `transcribe-media` media-curator skill with a sample transcript sidecar and discovery coverage.
28+
- Security-engineering cycle-1 scaffolds for banned APIs, sanitizer/fuzzing CI emitters, disclosure tracking, DFIR readiness, and external npm supply-chain audit provenance.
29+
- Community, browser-control, and Omnius integrator documentation surfaces.
30+
31+
### Changed
32+
33+
- Codex provider detection now uses runtime/process markers and mixed-workspace regression coverage for `regenerate`, `refresh`, `steward`, and related provider-selection paths.
34+
- Media-curator docs now describe transcript sidecars and research handoff preparation alongside archive curation.
35+
- Release configuration doc-sync guidance now includes all of `agentic/code/` and all repository Markdown files, reflecting where AIWG capabilities actually live.
36+
- Release tagging is configured to use `tools/release/cut-tag.sh` instead of a raw `git tag` command so the release signing key remains separate from the regular commit key.
37+
- The system-wide `cli-secondary` rule now states that raw CLI commands augment skill workflows; skills remain responsible for orchestration, final formatting, presentation, synthesis, gates, and recovery.
1038
- Claude Code external loop launches now default-disable 1M-context model variants unless `CLAUDE_CODE_DISABLE_1M_CONTEXT` is explicitly set, with docs covering the credit-account tradeoff and opt-in path.
11-
- Documented the project signing-key split in `AGENTS.override.md` and `.aiwg/release-process.md`: regular commits use the host commit key, while annotated release tags use the AIWG release key.
39+
- Project signing-key split is documented in `AGENTS.override.md` and `.aiwg/release-process.md`: regular commits use the host commit key, while annotated release tags use the AIWG release key.
40+
41+
### Fixed
42+
43+
- Channel sync and refresh provider-detection tests were stabilized.
44+
- Docsite deployment now normalizes the deploy root and verifies release artifacts more directly.
45+
- Address-issues and agent-loop paths were hardened, including malicious issue-body handling and stale-window closure auditing.
46+
- Media transcript discovery now routes `transcribe media` to the media-curator skill.
47+
48+
### Known follow-up
49+
50+
- The time-based media research epic remains open for REF templates, timestamp citation policy, citation sidecars, `induct-media`, and quickref/generated-guidance discoverability.
51+
- Cargo/Rust crate supply-chain discovery still routes to npm-specific audit guidance first and remains tracked as follow-up work.
52+
- Provider field-validation claims remain limited to sessions already evidenced in the issue tracker; remaining providers still need real session validation.
53+
- A repo-wide audit is open as #1480 to align docs, quickrefs, skill bodies, and generated guidance with the skill-first CLI augmentation rule.
54+
55+
### Tests
56+
57+
Release-prep verification for this line:
58+
59+
```bash
60+
npm run check:versions
61+
npm run typecheck
62+
npm run build:cli
63+
npm test
64+
npm run uat
65+
```
66+
67+
### Migration notes
68+
69+
No breaking changes. Projects using local issue stores should review `docs/local-issues.md` before enabling live sync so tracker direction, conflict handling, and credential sourcing are explicit.
1270

1371
## [2026.5.10] - 2026-05-19 — "Beginner onboarding wizard + docs"
1472

‎README.md‎

Lines changed: 6 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -513,15 +513,16 @@ If you ship a product that bundles AIWG and want to be listed here, open an issu
513513

514514
## What You Get
515515

516-
### Frameworks (6)
516+
### Frameworks (8)
517517

518518
| Framework | Agents | Templates | What It Does |
519519
|-----------|--------|-----------|--------------|
520520
| **[SDLC Complete](agentic/code/frameworks/sdlc-complete/)** | 98 | 200+ | Full software development lifecycle — Inception through Production with multi-agent orchestration, quality gates, and DORA metrics |
521521
| **[Forensics Complete](agentic/code/frameworks/forensics-complete/)** | 13 | 8 | Digital forensics and incident response — evidence acquisition, timeline reconstruction, IOC extraction, Sigma rule hunting. NIST SP 800-86, MITRE ATT&CK, STIX 2.1 |
522522
| **[Media/Marketing Kit](agentic/code/frameworks/media-marketing-kit/)** | 37 | 87+ | End-to-end marketing operations — strategy, content creation, campaign management, brand compliance, analytics, and reporting |
523-
| **[Media Curator](agentic/code/frameworks/media-curator/)** | 6 | — | Intelligent media archive management — discography analysis, source discovery, quality filtering, metadata curation, multi-platform export (Plex, Jellyfin, MPD) |
523+
| **[Media Curator](agentic/code/frameworks/media-curator/)** | 6 | — | Intelligent media archive management — discography analysis, source discovery, quality filtering, transcript sidecars, research handoff preparation, multi-platform export (Plex, Jellyfin, MPD) |
524524
| **[Research Complete](agentic/code/frameworks/research-complete/)** | 8 | 6 | Academic research automation — paper discovery, citation management, RAG-based summarization, GRADE quality scoring, FAIR compliance, W3C PROV provenance |
525+
| **[Knowledge Base](agentic/code/frameworks/knowledge-base/)** | — | 5 | General-purpose LLM-assisted wiki — source ingest, entity/concept pages, source summaries, comparisons, syntheses, health checks, and emergent taxonomy |
525526
| **[Ops Complete](agentic/code/frameworks/ops-complete/)** | 12 | 3 | Operational infrastructure — incident management, runbooks, troubleshooting workflows |
526527
| **[Security Engineering](agentic/code/frameworks/security-engineering/)** | 2 | 5 | Applied security beyond STRIDE/OWASP — cryptographic primitive selection, chain-of-trust integrity, authentication-factor architecture, degraded-mode design, runtime secret hygiene, supply-chain trust, physical-access threats. Pattern-based, product-agnostic |
527528

@@ -851,14 +852,15 @@ Full DFIR investigation workflow following NIST SP 800-86, with MITRE ATT&CK map
851852
/analyze-artist "Pink Floyd" # Identify eras, catalog structure
852853
/find-sources "Pink Floyd" "DSOTM" # Discover across YouTube, Archive.org, Bandcamp
853854
/acquire # Download with format selection
855+
/transcribe-media /path/to/media.wav # Create timestamped transcript sidecars
854856
/tag-collection # Apply metadata, embed artwork, rename
855857
/check-completeness # Gap analysis against canonical discography
856858
/assemble "Pink Floyd live 1973" # Build thematic compilations
857859
/export --format plex # Export to Plex, Jellyfin, MPD, or archival
858860
/verify-archive # SHA-256 integrity verification
859861
```
860862

861-
Quality tiers: Tier 1 (Official/Lossless) → Tier 2 (High Quality) → Tier 3 (Acceptable) → Tier 4 (Avoid). Standards: ID3v2.4, Vorbis Comments, MusicBrainz, PREMIS 3.0, W3C PROV-O.
863+
Quality tiers: Tier 1 (Official/Lossless) → Tier 2 (High Quality) → Tier 3 (Acceptable) → Tier 4 (Avoid). Transcript sidecars preserve source hashes, transcript hashes, timestamps, and optional speaker labels for review and future research handoff. Standards: ID3v2.4, Vorbis Comments, MusicBrainz, PREMIS 3.0, W3C PROV-O.
862864

863865
### Research Complete — Academic Research Pipeline
864866

@@ -1299,7 +1301,7 @@ AIWG uses a unified extension system with 10 extension types, all deployable acr
12991301
| **Skills** | 128 | Natural language workflow triggers activated by conversation patterns |
13001302
| **Rules** | 35 | Enforcement patterns deployed as consolidated index with on-demand full-rule loading |
13011303
| **Templates** | 334 | Progressive disclosure document templates for all SDLC phases |
1302-
| **Frameworks** | 6 | Complete workflow systems (SDLC, Forensics, Marketing, Research, Media Curator, Ops) |
1304+
| **Frameworks** | 8 | Complete workflow systems (SDLC, Forensics, Marketing, Research, Media Curator, Ops, Knowledge Base, Security Engineering) |
13031305
| **Addons** | 21 | Feature bundles extending frameworks (RLM, Voice, Testing Quality, UAT, Ring) |
13041306
| **Hooks** | varies | Lifecycle event handlers (pre-session, post-write, workflow tracing) |
13051307
| **Tools** | varies | External utility integrations (git, jq, npm) |

0 commit comments

Comments
 (0)